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
TypeScriptMITCreated 2024-08-05demo.yournextstore.com
Download: v1.0.0v1.0.0 ↓1.0.02026-01-26
+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 e

Top issues

Discussions

Latest release

v1.0.0 v1.0.0 2026-01-26
Your 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON