Documentation
A personal scaffold for shipping zero-cost, static-first web apps — with methodology, ethics, and orchestration baked in.
What’s inside
This scaffold is opinionated. It ships with the stack, the workflow, the ethics framework, and the visual-regression harness already in place — so your first commit is feature work, not config.
Stack
Astro 5, React 19, Tailwind v4, shadcn/Base UI (not Radix), TanStack
Table + Query + Virtual, Tremor Raw KPIs, Recharts, Motion (post-Framer),
@vite-pwa/astro, Nano Stores. → Stack overview
How we work
Shape Up cadence (not Scrum), red→green TDD with Tdd-Red: commit
trailers, Zod-driven Spec-DD, Claude Code orchestration with three
sub-agents. → Inceptor
Ethics & UX
8-item ethics checklist grounded in BJ Fogg’s Persuasive Technology.
Tiered enforcement: tier-0 skips docs PRs, tier-1 covers UI tweaks,
tier-2 covers new persuasive surfaces. Mechanical risk:high triggers.
→ Persuasive-tech framework
Building
How to add a component, how hydration works, what the compound-component gotcha is, how to theme, how to test. → Adding a component
Quick links
- Quick start — get running in 5 minutes
- What you get — feature inventory
- The 60-second Inceptor tour — workflow walkthrough
- Forbidden imports — what this scaffold refuses to ship
- Commands cheatsheet — every
npm runscript - Decisions — ADRs
The repo lives at github.com/ArtemioPadilla/TradePilot.