Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-setup-stack
saas-setup-stack
UnverifiedConfigure SaaS stack (Golden Stack for founders or custom Next.js/FastAPI/Go/Cloudflare).
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.4 KB |
| references/11-upgrade.md | markdown | 4.4 KB |
| references/12-output-summary.md | markdown | 1.8 KB |
| references/2-guided-mode.md | markdown | 1.7 KB |
| references/3-version.md | markdown | 2.0 KB |
| references/4-claude-md-stack.md | markdown | 2.0 KB |
| references/5-technical-preferences.md | markdown | 5.9 KB |
| references/5.5-project-yaml.md | markdown | 1.8 KB |
| references/6-knowledge-gap.md | markdown | 1.7 KB |
| references/7-reference-docs.md | markdown | 5.9 KB |
| references/7.5-scaffold.md | markdown | 2.5 KB |
| references/8-verify.md | markdown | 921 B |
| references/saas-stack-config.md | markdown | 4.5 KB |
references/5.5-project-yaml.md
View on GitHub# SaaS Stack Configuration Reference (project.yaml)
This reference documents the structure, commands, and fields required in `project.yaml`.
---
## 1. Minimal Working Configuration
```yaml
schema_version: "2.0"
product:
name: "MySaaS"
slug: "my-saas"
tier: "b2b"
stack:
frontend: "nextjs"
backend: "fastapi"
database: "postgresql"
orm: "prisma"
auth: "supabase"
billing: "stripe"
cloud: "vercel"
commands:
build: "npm run build"
test: "npm test"
run: "npm run dev"
lint: "npm run lint"
smoke: "curl -f http://localhost:3000/api/health || exit 1"
modes:
automation: "collaborative"
rigor: "standard"
review_mode: "lean"
docs:
density: "balanced"
```
---
## 2. Standard Stack Definitions
### Next.js Fullstack (Default)
- **Frontend**: Next.js 15+ (App Router, React 19, TypeScript, Tailwind CSS)
- **Backend**: Next.js Route Handlers / Server Actions
- **Database**: PostgreSQL (Supabase / Neon) via Prisma ORM
- **Commands**:
- `build`: `npm run build`
- `test`: `npm test` (Vitest)
- `run`: `npm run dev` (starts on port 3000)
- `smoke`: `curl -s -f http://localhost:3000/api/health`
### Next.js + FastAPI (AI & Heavy Compute)
- **Frontend**: Next.js (port 3000)
- **Backend**: FastAPI (Python async, port 8000)
- **Database**: PostgreSQL via SQLAlchemy / Alembic
- **Commands**:
- `build`: `npm run build && pip install -r requirements.txt`
- `test`: `pytest && npm test`
- `run`: `uvicorn main:app --reload --port 8000`
- `smoke`: `curl -s -f http://localhost:8000/health`
---
## 3. Platform & Target Matrix
```yaml
platform:
targets:
- web-desktop
- web-mobile
primary_input: "keyboard-mouse"
mobile_responsive: true
pwa: false
```
---
## 4. Verification
Run `/saas-smoke-check` or `bash .claude/scripts/project-state.sh` to confirm stack resolution.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |