New Project
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
git clone https://github.com/yournextstore/yournextstore.gitcd yournextstore && bun installcp .env.example .env.local # Add your YNS_API_KEY from https://yns.store/manage/settings/apibun devOpen 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.
Themes
Your Next Store ships with 30+ ready-made themes across different store categories. Each theme includes a fully redesigned homepage, hero, color palette, and section layout — all built on the same core codebase.
Switch themes with a single command:
git checkout theme-beauty-sereneAll Themes
| Category | Themes |
|---|---|
| Beauty | beauty-aura · beauty-blush · beauty-glow · beauty-serene |
| Fashion | fashion-atelier · fashion-aurum · fashion-blanc · fashion-capsule · fashion-fjord · fashion-luxette · fashion-nomad · fashion-oslo · fashion-portia · fashion-stride · fashion-trailhead |
| Furniture | furniture-forma · furniture-grove · furniture-vela |
| Food | food-matcha · food-sizzle |
| Electronics | electronics-nexus · electronics-pulse |
| Health | health-botanica · health-hemlock |
| Home | home-deskflow · home-vessel |
| Events | events-gather · events-signal |
| Auto | auto-nightshift · auto-torque |
| Kids | kids-wonder |
All theme branches are prefixed with
theme-(e.g.theme-fashion-blanc). Themes modify only visual components and static assets — your products, cart, and checkout remain unchanged.
