At a Glance:
Your Next Store is an open-source, AI-native e-commerce template built with Next.js 16 and Stripe, specifically optimized for AI coding tools like Claude Code and Cursor through typed Commerce Kit SDK methods and an AGENTS.md file.
Overview:
Your Next Store is an open-source Next.js e-commerce starter template that provides a production-ready storefront with direct Stripe integration for checkout, billing, and subscriptions. It is explicitly designed as an AI-native codebase, shipping with an AGENTS.md file that provides full project context, idiomatic patterns, and a typed Commerce Kit SDK with defined method contracts like productBrowse() and cartUpsert(). This structure allows AI coding assistants to understand the domain model and write correct code without inventing data structures. The template is built on the App Router with React Server Components and React Compiler, uses Bun as the runtime, and includes over 30 ready-made visual themes switchable via a single command.
Key Decision Points:
AI coding tool compatibility: The project ships with AGENTS.md and typed SDK methods, making it specifically suited for development workflows using Claude Code, Cursor, or Codex that benefit from explicit contracts.
Stripe-native architecture: Payment processing, checkout, and subscription handling are built directly on Stripe APIs without abstraction layers, making the payment logic transparent and directly configurable in the Stripe Dashboard.
Theme switching mechanism: Over 30 category-specific themes are available as separate branches prefixed with
theme-, modifying only visual components and static assets while leaving product data, cart, and checkout logic unchanged.Deployment flexibility: The template can be self-hosted on any infrastructure or deployed to Vercel in one click, with no runtime dependency on the YNS maintainers beyond the initial Stripe configuration.
Core Features:
Commerce Kit SDK: Typed headless commerce methods with defined input/output contracts (e.g.,
productBrowse(),cartUpsert()) that provide predictable APIs for both human developers and AI agents.AGENTS.md context file: A machine-readable project manifest that includes SDK examples, coding conventions, Biome rules, and a validation checklist so AI tools can operate with full codebase understanding before writing code.
Stripe API integration: Direct implementation of Stripe checkout, billing, and subscription features without middleware abstraction, allowing configuration entirely through the Stripe Dashboard.
30+ branch-based themes: Ready-made visual themes across categories like fashion, beauty, furniture, electronics, and food, applied via single-command branch switching that isolates visual changes from business logic.
Next.js 16 App Router stack: Uses React Server Components, Server Actions, and the React Compiler with strict TypeScript, Biome for linting/formatting, Tailwind CSS v4, and Shadcn UI components.
Use Cases:
Developers building Stripe-powered storefronts: Teams or individuals who want a working e-commerce frontend that integrates directly with Stripe and can be customized through a well-typed SDK rather than building payment flows from scratch.
AI-assisted development workflows: Developers using AI coding tools who need a project with explicitly defined data models, typed method contracts, and machine-readable project context to produce reliable, correct code modifications.
Multi-brand or multi-category store experiments: Developers who need to launch or test different store visual identities quickly, using the theme branch system to switch between category-specific designs without altering product or checkout logic.
Open-Source Alternative Value:
Your Next Store provides a self-hostable e-commerce frontend where the complete source code, payment integration, and theming system are available and modifiable. Because it uses direct Stripe API calls rather than a proprietary middleware, the payment logic is inspectable and the billing configuration remains fully controlled through the user's own Stripe account. The AGENTS.md file and typed SDK contracts serve as an auditable integration layer that AI tools can consume, while the branch-based theme architecture allows visual customization without forking core commerce logic, making the template adaptable without losing upstream compatibility.