Skip to content

yournextstore/yournextstore

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

373 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Your Next Store

Open-source AI-native Next.js e-commerce template.

Powered by Stripe. Built for AI coding tools.

GitHub Stars Deploy with Vercel Discord Product Hunt

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.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

Prerequisites

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-serene

All 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.

Star History

Star History Chart

About

AI-Native Open-Source Next.js commerce. Powered by Stripe. Ultra fast with typesafe Commerce SDK. Built for AI development (Claude, Codex, Cursor).

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors

Languages