claudeers.
// Uncategorized / Others

yournextstore

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

// Uncategorized / Others[ cli ][ api ][ web ][ claude ]#claude#ai-friendly#ai-native#bun#commerce#nextjs#reactjs#stripe#uncategorized◷ MIT$open-sourceupdated 21 days ago
Actively maintained
100/100
last commit 4 days ago
last release 10 months ago
releases 1
open issues 2

Install with your AI

Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.

Install and set up yournextstore (git-clone project) into my current project.
Found on https://claudeers.com/yournextstore
Repo: https://github.com/yournextstore/yournextstore
Homepage/docs: https://demo.yournextstore.com
Detected install method: git-clone → git clone https://github.com/yournextstore/yournextstore
Category: uncategorized. Platforms: cli, api, web.
Read the repo's README for exact setup and env vars, then install it and wire it into my project.

Claudeers Health Verdict:
active; community-verified: false. Confirm the source before running anything.
// or clone
git clone https://github.com/yournextstore/yournextstore

// compatibility

Platformscli, api, web
Operating systems—
AI compatibilityclaude
LicenseMIT
Pricingopen-source
LanguageTypeScript

Get your FREE $2.50 API credits to access TickAtlas financial data ↗

yournextstore

Your Next Store

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

Powered by Stripe. Built for AI coding tools.

Your Next Store Demo

Live Demo: demo.yournextstore.com


AI-Friendly CodebaseShips with AGENTS.md — idiomatic patterns, Commerce Kit SDK with typed methods. Claude Code, Cursor, and Codex work out of the box
Stripe-NativeDirect Stripe API integration — checkout, billing, subscriptions
Next.js 16App Router, React Server Components, React Compiler
Open SourceSelf-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 patternsIdiomatic Next.js App Router (Server Components, Server Actions, "use cache") — matches what LLMs have seen thousands of times
Commerce Kit SDKMethods like productBrowse() and cartUpsert() have defined input/output shapes. LLMs write correct code when they know the contracts
Well-defined domainProducts, variants, carts, checkout — the data models already exist with clear types. No need for the LLM to invent them
AGENTS.mdFull 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

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):

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 every /api/v1/* endpoint (see the API documentation).

Updating a store to the template

A YNS store is a copy of this repo with no shared history, so it never picks up template changes on its own. Stores update through the Upgrade button in Design: Elliot's upgrade-storefront skill (in the YNS platform repo, agent/skills/upgrade-storefront) brings in each template change file by file, keeps the store's look, and records the template commit it reached in .yns/template.json. The same script runs on a store checkout:

UPGRADE=<platform>/agent/skills/upgrade-storefront/scripts/upgrade.ts
bun $UPGRADE --store <store dir>           # plan: what would change
bun $UPGRADE --store <store dir> --apply   # apply everything safe; conflicts are left for you
bun $UPGRADE --store <store dir> --record  # after a full refresh: write .yns/template.json

Don't merge or rebase a store onto the template. Its main is published, and Design's version history restores published versions by their commit.

The three platform-managed files (proxy.ts, lib/track.tsx, instrumentation-client.ts) are the exception: every publish restores them from the store's own main, so a change to them goes out to every store with the store-propagate skill.

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

Themes live on branches named theme-001 … theme-149. Switch themes with a single command:

git checkout theme-016

Browsing themes

Each theme branch is a single commit on top of main whose message describes the theme's vibe. List them all (id + description) with:

git for-each-ref --sort=refname --format='%(refname:short)  %(subject)' 'refs/remotes/origin/theme-*'

All theme branches use a zero-padded three-digit id (theme-001 … theme-149). Themes modify only visual components and static assets — your products, cart, and checkout remain unchanged.

Star History

Star History Chart

// faq

What is yournextstore?

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

Is yournextstore free to use?

yournextstore is open-source under the MIT license, so it is free to use.

What category does yournextstore belong to?

yournextstore is listed under uncategorized in the Claudeers registry of Claude-compatible tools.

21 views
★ 5,541 stars
unclaimed
updated 21 days ago

// embed badge

yournextstore on Claudeers
[![Claudeers](https://claudeers.com/api/badge/yournextstore.svg)](https://claudeers.com/yournextstore)

// retro hit counter

yournextstore hit counter
[![Hits](https://claudeers.com/api/counter/yournextstore.svg)](https://claudeers.com/yournextstore)

// reviews

// guestbook

0/500

// related in Uncategorized / Others

🔓

Reverse engineer anything with agents, from app behavior down to native binaries.

// uncategorizedmorluto/⟨TypeScript⟩★ 468,336◷ MIT[ claude ]
🔓

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

// uncategorizedn8n-io/⟨TypeScript⟩★ 211,436◷ NOASSERTION[ claude ]
🔓

The agent engineering platform.

// uncategorizedlangchain-ai/⟨Python⟩★ 149,929◷ MIT[ claude ]
🔓

100+ AI Agent & RAG apps you can actually run — clone, customize, ship.

// uncategorizedShubhamsaboo/⟨Python⟩★ 144,747◷ Apache-2.0[ claude ]

// built by

1 of its contributors also build on official projects — claude-cookbooks, claude-quickstarts

→ see how yournextstore connects across the ecosystem