Skip to main content

ASA CLI v2 - Slice-oriented architecture tool for AI-built apps

Project description

ASA CLI v2 — Starter Kit

Slice-oriented architecture tool for AI-built apps. New repo from scratch. Replaces asa-starter-kit + asa-cli.

Quick Start

pip install -e ".[dev]"
asa --help

Commands

Public Core (9)

Command Role Description
asa init Builder Initialize ASA project (config, domains/, shared/)
asa scan Diagnostic ACI score, structural risk, hotspots
asa install <module> Builder Install foundation module (auth-basic, db-basic, payments-basic)
asa slice new <name> Builder Create new vertical slice (FE + BE + contract)
asa slice update <name> Builder Regenerate slice (preserve user code via markers)
asa slice plan <spec> Builder Spec → slice architecture proposal
asa slice split <name> Builder Analyze oversized slice, propose split
asa lint Enforcement Boundary, contract, security checks
asa deploy Delivery Vercel + Supabase deployment

Advanced (4)

Command Description
asa slice build <name> Run internal build pipeline (contract → zod → skeleton)
asa slice sync Validate all contracts across project
asa slice analyze <name> Detailed slice analysis (LOC, coupling, complexity)
asa ui generate <name> Regenerate frontend part of slice

ASA Native Stack v1

All generated code targets this stack:

  • Frontend: Next.js (App Router) + TypeScript + React
  • UI: Tailwind CSS + shadcn/ui
  • Backend: Next.js route handlers / server actions
  • Database: PostgreSQL via Supabase
  • Auth: Supabase Auth (SSR/cookie-based)
  • Payments: Stripe
  • Deploy: Vercel + Supabase

Foundation Modules

Module Command What it creates
db-basic asa install db-basic Supabase client, types, utils, migrations framework
auth-basic asa install auth-basic 4 slices (register, login, logout, reset-password) + middleware + session
payments-basic asa install payments-basic 4 slices (subscribe, cancel, webhook, check-limits) + Stripe config

Documentation

Development

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check .

# Type check
mypy asa/

Related

Resource Repo
Distribution janvoldan/asa-cli
Demo 02 spec janvoldan/02-asa-demo-spec
v1 source (archived) janvoldan/asa-starter-kit-old-bck
v1 distribution (archived) janvoldan/asa-cli-old-bck

v2.0.0 — 2026-03-08

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

asa_standard-2.1.0.tar.gz (57.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

asa_standard-2.1.0-py3-none-any.whl (100.8 kB view details)

Uploaded Python 3

File details

Details for the file asa_standard-2.1.0.tar.gz.

File metadata

  • Download URL: asa_standard-2.1.0.tar.gz
  • Upload date:
  • Size: 57.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.12

File hashes

Hashes for asa_standard-2.1.0.tar.gz
Algorithm Hash digest
SHA256 2eaa12038bbfcbdfd624945a0409c4df08eea1e2685a8aaca74515382d1e80b0
MD5 1b6d68a2e6bc16fc85899116bd994a00
BLAKE2b-256 c1dbb0c23671e1f5e6edf315a5c4b8de64afab5bf8ac25abfdc55b031cee951b

See more details on using hashes here.

File details

Details for the file asa_standard-2.1.0-py3-none-any.whl.

File metadata

  • Download URL: asa_standard-2.1.0-py3-none-any.whl
  • Upload date:
  • Size: 100.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.12

File hashes

Hashes for asa_standard-2.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 abf4a00c658e502774f4f83f7e8fbde32b23ad5000629d8216df3fa79ba41c50
MD5 563005406ded3cea248959181fd8316c
BLAKE2b-256 c21f17207f45f54814a878d9fe84f42b9c7ac3d45c05a38f15ea6f212e944bf8

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page