yournextstore /yournextstore
AI-Native Open-Source Next.js commerce. Powered by Stripe. Ultra fast with typesafe Commerce SDK. Built for AI development (Claude, Codex, Cursor).
★ 5,539⑂ 675👁 41⑃ 132● 96▤ 1
+1
Daily
5,539
stars
675
forks
41
watchers
132
prs
96
issues
1
releases
README
Your Next Store
Open-source AI-native Next.js e-commerce template.
Powered by Stripe. Built for AI coding tools.
Live Demo: demo.yournextstore.com
| | |
|:---|:---|
| 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
bash
git clone https://github.com/yournextstore/yournextstore.git
cd yournextstore && bun install
cp .env.example .env.local Add your YNS_API_KEY from https://yns.store/manage/settings/api
bun dev
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
Performance and accessibility defaults — prerendered chrome on every route, optimizer-served icons,
WCAG-AA colour tokens, tappable controls — are spelled out in AGENTS.md
and checked by bun run build and bun test.
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
Publishing & Store API from the CLI
Two small scripts in scripts/ talk to the YNS platform using only the store's YNS_API_KEY (read from .env.local / .env):
bash
bun run publish:store Trigger a production publish (same as the admin "Publish" button) and wait for the build
bun run publish:store --no-wait Fire and forget
bun run api GET /products?limit=5 Call any Store API endpoint
bun run api POST /products '{"name":"Tee","price":29.99}'
scripts/publish.sh deploys the tenant repo's remote main — push your commits first. scripts/api.sh is a thin wrapper around curl that handles auth, base-URL resolution, and pretty JSON output for eTop issues
Discussions
#234Idea: a checked support reference alongside an order confirmation0 comments · 2026-10-27#116v1.0.00 comments · 2026-01-26#77Trieve Functionality.1 comments · 2024-11-23#65Welcome to YNS Discussions!0 comments · 2024-11-06
Latest release
v1.0.0 v1.0.0 2026-01-26Your Next Store - Storefront Template for LLMs v1.0.0 This is the first stable release of the Your Next Store LLM-friendly template; an open-source, Stripe-native Next.js storefront built to work with AI coding tools. - idiomatic Next.js App Router patterns; predictable for Claude, Codex, Cursor - fully typed commerce APIs; fewer hallucinations, more correct code - Stripe-native checkout; no plugins, no glue layers - fast by default; Next.js 16, React Server Components, edge caching This release is about stability, clarity, and making AI-assisted commerce development boring in the