Installation

Prerequisites

• Node.js 18.17 or greater (22 recommended). Check with node -v.
• pnpm (recommended) or npm/yarn. Install pnpm: npm install -g pnpm.

1. Clone the Repository

git clone https://github.com/NextBento-dev/nextbento.git your-app-name
cd your-app-name

2. Install Dependencies

Using pnpm (recommended):

pnpm install

Or with npm:

npm install

3. Environment Setup

Copy the example environment file:

cp .env.example .env.local

Edit .env.local with your service credentials. You'll need:

• Supabase — Project URL and anon key (see Supabase Setup)
• Stripe — Secret key, publishable key, webhook secret (see Stripe Setup)
• Resend — API key (see Resend Domain Verification)

See Environment Variables for the full list.

4. Run the Development Server

pnpm dev

Open http://localhost:3000 in your browser.

5. First Run

On first load you may see:

• Auth errors — Expected until Supabase is configured
• Stripe errors — Expected until Stripe is configured
• Redirect to login — Dashboard routes require authentication

Complete Supabase Setup, Stripe Setup, and Resend Domain Verification to resolve these.

Troubleshooting

Port 3000 already in use

pnpm dev -- -p 3001

Module not found errors

Clear the cache and reinstall:

rm -rf .next node_modules
pnpm install
pnpm dev

Supabase connection errors

Verify NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY in .env.local. Ensure your Supabase project is running.

Stripe webhook errors

Use the Stripe CLI to forward webhooks locally. See Stripe Setup.

Next Steps

• Quick Start — 5-minute setup flow
• Supabase Setup — Configure authentication
• Stripe Setup — Configure payments