Skip to content

Basinfy/Basinfy-SaaS-Studio / .agents/skills/saas-setup-stack

saas-setup-stack

Unverified

Configure SaaS stack (Golden Stack for founders or custom Next.js/FastAPI/Go/Cloudflare).

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.
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
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: 194kUpdated Claude CodeCodexVerifiedInstall