A modern and efficient e-commerce solution tailored for startups, enabling seamless setup and free hosting on Vercel and Supabase Cloud.
- Node.js
- Supabase (requires Docker)
- Google ReCaptcha
- MixPay (Payment)
- PayStack (Payment)
- Sentry (Optional)
First by creating a supabase cloud project:
- go to Supabase Dashboard
- click
New Project - choose:
- Organization → (create one if needed)
- Project Name → e.g. super-ulisha-store-app
- Database Password → choose a secure one
- Region → pick the nearest location
- Click Create new project
- Wait a few moments for the database to be provisioned.
Copy the .env.example to .env
cp .env.example .env| Variable | Description | Location |
|---|---|---|
NEXT_PUBLIC_SUPABASE_URL |
Your Supabase project URL (e.g., https://<project-id>.supabase.co) |
Supabase Project → Settings → General → Project URL |
NEXT_PUBLIC_SUPABASE_ANON_KEY |
Public anonymous key for client-side access | Supabase Project → Settings → API → Project API Keys |
SUPABASE_SERVICE_ROLE_KEY |
Service role key for server-side access ( |
Supabase Project → Settings → API → Project API Keys |
Login first (if you haven't):
npx supabase loginLink the cloud project to this local one:
npx supabase linkIt'll show the list of project you have select your project.
Push migrations to cloud:
npx supabase db pushPull migrations from cloud:
npx supabase db pullUpdating types (if you ever changed migrations):
npx supabase gen types typescript --project-id <project-id> --schema public > src/supabase-types.tsCreating a bucket:
- Go to your project storage -> buckets
- Create new bucket name
product-images
Seed the database:
npm run db:seedTo start a local development server, run:
npm run devOnce the server is running, open your browser and navigate to http://localhost:4000/. The application will automatically reload whenever you modify any of the source files.
To build the project run:
npm run buildThis will compile your project and store the build artifacts in the dist/ directory. By default, the production build optimizes your application for performance and speed.
This project is licensed under the Polyform Noncommercial License 1.0.0.
© 2025 Ulisha Limited.