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
- Implementation Spec — full technical specification
- Commands Reference — user-facing docs (TODO)
- Architecture — internal architecture (TODO)
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
Release history Release notifications | RSS feed
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)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
asa_standard-2.1.0-py3-none-any.whl
(100.8 kB
view details)
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2eaa12038bbfcbdfd624945a0409c4df08eea1e2685a8aaca74515382d1e80b0
|
|
| MD5 |
1b6d68a2e6bc16fc85899116bd994a00
|
|
| BLAKE2b-256 |
c1dbb0c23671e1f5e6edf315a5c4b8de64afab5bf8ac25abfdc55b031cee951b
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
abf4a00c658e502774f4f83f7e8fbde32b23ad5000629d8216df3fa79ba41c50
|
|
| MD5 |
563005406ded3cea248959181fd8316c
|
|
| BLAKE2b-256 |
c21f17207f45f54814a878d9fe84f42b9c7ac3d45c05a38f15ea6f212e944bf8
|