Back to Templates
| AI-Friendly Codebase | Ships with AGENTS.md — idiomatic patterns, Commerce Kit SDK with typed methods. Claude Code, Cursor, and Codex work out of the box |
| Stripe-Native | Direct Stripe API integration — checkout, billing, subscriptions |
| Next.js 16 | App Router, React Server Components, React Compiler |
| Open Source | Self-host anywhere, deploy to Vercel in one click |
Quick Start
Open localhost:3000 — your store is running.
Why AI Tools Work Better Here
| Familiar patterns | Idiomatic Next.js App Router (Server Components, Server Actions, "use cache") — matches what LLMs have seen thousands of times |
| Commerce Kit SDK | Methods like productBrowse() and cartUpsert() have defined input/output shapes. LLMs write correct code when they know the contracts |
| Well-defined domain | Products, variants, carts, checkout — the data models already exist with clear types. No need for the LLM to invent them |
| AGENTS.md | Full project context, SDK examples, Biome rules, and validation checklist — AI agents understand the codebase before writing a single line |
Tech Stack
- Next.js 16 — App Router, React Server Components, React Compiler
- Bun — Fast JavaScript runtime and package manager
- Commerce Kit SDK — Headless commerce API integration
- Tailwind CSS v4 — Utility-first styling
- Shadcn UI — 50+ accessible components built on Radix UI
- TypeScript — Strict type-safe development
- Biome — Lightning-fast linter and formatter
Prerequisites
- Node.js 24+
- Bun 1.0+
- YNS API key from https://yns.store/manage/settings/api
Environment Variables
Copy .env.example to .env.local and set:
YNS_API_KEY— Your API token from the admin panel
Contributing
See CONTRIBUTING.md for coding conventions and PR checklist.
Next Steps
Refer to the API documentation for details on fetching products, managing carts, and building on top of YNS.
