Vibe Storefront is a Next.js prototype that turns a plain-English product idea into a shareable storefront concept. It generates structured storefront copy with the OpenAI Codex SDK, creates product imagery with the OpenAI Image API, saves the result to Supabase, and publishes a public share page.
Demo: https://vibe-storefront.com
- Next.js 16 App Router, React, TypeScript, Tailwind CSS
- Clerk for authentication
- Supabase Postgres, Row Level Security, and Storage
@openai/codex-sdk,@openai/codex, and the OpenAI Image API- Vitest, Testing Library, and Playwright
Use Node.js 24.x. If you use nvm, run nvm use from the repo root.
Copy the local environment template and fill in development keys:
cp .env.example .env.localInstall dependencies, start the local Supabase stack, and run the app:
npm install
npx -y supabase start
npm run devOpen http://localhost:3000.
Local Supabase requires a Docker-compatible container runtime such as Docker Desktop, OrbStack, Rancher Desktop, or Podman. Use Clerk development keys locally. See docs/local-development.md for the full local setup and manual smoke-test flow.
The Reveal.js project deck is available at http://localhost:3000/deck in local development and /deck in deployed environments. Press S while viewing the deck to open Reveal.js speaker view with notes for the current slide.
Export the deck and speaker notes to PDF:
npm run deck:pdfThe generated PDF is written to deck-export/vibe-storefront-codex-deck.pdf. Open http://localhost:3000/deck?print-pdf for manual browser printing.
Run the consolidated check before publishing changes:
npm run verifynpm run verify runs typecheck, lint, unit tests, production build, and the Playwright browser smoke test sequentially.
docs/local-development.md- local environment setup, Supabase, Clerk, and smoke testing.docs/project-context.md- runtime architecture, persistence boundaries, generation limits, and image backfill notes.docs/deployment-checklist.md- production environment, migrations, Vercel, and deployment verification.
Open source under the MIT License. You can use, copy, modify, merge, publish, distribute, sublicense, and sell copies of this project, provided the copyright and license notice stay with the software.