Skip to content

docs: fix accuracy discrepancies vs codebase #5

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
MasonStation wants to merge 1 commit into
base: feat/templates-add-vercel
Choose a base branch
from
Open

docs: fix accuracy discrepancies vs codebase #5

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@ In a Claude‑Code‑native world, the friction in starting a project isn't writ
Stack collapses that hour into one command:

```bash
stack init --template nextjs-supabase-posthog-sentry
stack init --template nextjs-supabase-posthog
# Stack does the OAuth dance per provider,
# creates the upstream resource,
# stores every secret in Phantom,
Expand Down Expand Up @@ -86,14 +86,14 @@ Stack is the *control plane*. [Phantom](https://phm.dev) is the *vault*. ashlr-p
**Email** — Resend
**Auth** — Clerk

29 providers total. Run `stack providers` to see the live catalog.
39 providers total. Run `stack providers` to see the live catalog.

## Usage

```bash
stack init # interactive template picker
stack add supabase # OAuth → new project → secrets → .mcp.json
stack providers # full catalog (29 services across 11 categories)
stack providers # full catalog (39 services across 11 categories)
stack doctor --fix # verify every service; re-run setup for anything broken
stack exec -- bun dev # run with Phantom's secret proxy active
```
Expand Down
12 changes: 6 additions & 6 deletions STACK.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -19,10 +19,10 @@ third-party service in a developer's project with one command.

## Quick orientation

- 22 CLI commands live under `packages/cli/src/commands/*.ts`
- 23 providers under `packages/core/src/providers/*.ts` (factory: `_api-key.ts`; pilot: `supabase.ts`)
- 17 MCP tools listed in `packages/mcp/src/server.ts` — each shells out to the CLI
- 69 tests across `packages/core/src/__tests__/` — run with `bun test` from the repo root
- 26 CLI commands live under `packages/cli/src/commands/*.ts`
- 39 providers under `packages/core/src/providers/*.ts` (factory: `_api-key.ts`; pilot: `supabase.ts`)
- 19 MCP tools listed in `packages/mcp/src/server.ts` — each shells out to the CLI
- ~352 tests across 48 files — run with `bun test` from the repo root
- Site is Astro 5 + Tailwind v4 + Framer Motion

## Coding conventions (actually followed here)
Expand Down Expand Up @@ -65,7 +65,7 @@ third-party service in a developer's project with one command.

## Do NOT do these

- Do not create new packages without a reason — the four in `packages/*` cover the architecture.
- Do not create new packages without a reason — the six in `packages/*` cover the architecture.
- Do not add a runtime dependency to `@ashlr/stack-core` that isn't already there (Bun + smol-toml is the whole surface; we want to keep `npm install @ashlr/stack` fast).
- Do not modify `packages/site/src/pages/index.astro` layout without checking in with a human — it's the load-bearing hero.
- Do not bypass Phantom by writing secrets to disk "temporarily."
Expand All @@ -76,7 +76,7 @@ third-party service in a developer's project with one command.

```bash
bun install
bun test # 69 pass, 0 fail
bun test # ~352 tests across 48 files
bunx tsc --noEmit -p tsconfig.json
cd packages/site && bunx astro check # 43 files / 0 errors
cd packages/site && bun run build
Expand Down
Loading