Local Development Setup

Prerequisites

Before you begin, ensure you have the following installed:

Node.js

Version 18.x or higher

node --version

pnpm

Preferred package manager

npm install -g pnpm

Supabase CLI

For local database

brew install supabase/tap/supabase

Xcode

For iOS development (Mac only)

Xcode 15+
iOS Simulator

1. Clone the Repositories

mkdir popup && cd popup

# Clone all three repos
gh repo clone unfinished-bizness/getpopup-store
gh repo clone unfinished-bizness/popup-supabase
gh repo clone unfinished-bizness/popupstore.ios

2. Setup Supabase Backend

Start Supabase locally

cd popup-supabase
supabase start

This will output your local Supabase credentials. Save these!

Note the credentials

API URL: http://127.0.0.1:54321
anon key: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
service_role key: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Run migrations

supabase db reset

3. Setup Web Store

Install dependencies

cd ../getpopup-store
pnpm install

Create .env.local

.env.local

# Supabase
NEXT_PUBLIC_SUPABASE_URL=http://127.0.0.1:54321
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key_here
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key_here

# Razorpay (test mode)
NEXT_PUBLIC_RAZORPAY_KEY_ID=rzp_test_xxxxx
RAZORPAY_KEY_SECRET=xxxxx

# PostHog (optional)
NEXT_PUBLIC_POSTHOG_KEY=phc_xxxxx
NEXT_PUBLIC_POSTHOG_HOST=https://app.posthog.com

# Resend (for emails)
RESEND_API_KEY=re_xxxxx

Update hosts file

Add test subdomains to /etc/hosts:

sudo nano /etc/hosts

Add these lines:

127.0.0.1   teststore.localhost
127.0.0.1   myshop.localhost

Run dev server

pnpm dev

Open http://teststore.localhost:3000

4. Setup iOS App (Mac only)

Install dependencies

cd ../popupstore.ios
pod install  # If using CocoaPods

Configure Supabase

Update Configuration/Development.xcconfig:

SUPABASE_URL = http://127.0.0.1:54321
SUPABASE_ANON_KEY = your_anon_key_here

Open in Xcode

open popupstore.xcworkspace

Run on simulator

Select a simulator (iPhone 15 Pro)
Press Cmd + R to build and run

Test Data

The local Supabase instance comes with seed data:

Test Users

Email: seller@test.com
Password: password123
Store: teststore

Test Products

5 sample products with images
2 categories (Electronics, Clothing)
Various price points

Test Orders

3 pending orders
2 completed orders
Mix of UPI and Razorpay payments

Verify Setup

Web Store
iOS App
Supabase

Visit http://teststore.localhost:3000You should see:

✅ Store homepage with products
✅ Working cart functionality
✅ Checkout flow

Troubleshooting

Subdomain routing not working

Make sure you:

Updated /etc/hosts with test domains
Using .localhost:3000 (not localhost:3000)
Middleware is detecting subdomains correctly

Check middleware logs:

# In getpopup-store/src/middleware.ts
console.log('Host:', req.headers.get('host'))

Supabase connection errors

Verify Supabase is running:

supabase status

Check .env.local has correct credentials:

cat .env.local | grep SUPABASE

iOS build fails

Common fixes:

Clean build folder: Cmd + Shift + K
Delete derived data
Update Swift package dependencies
Restart Xcode

Stuck? Join our Discord or create an issue on GitHub

Getting Started

Architecture

Seller Guide

Integrations

Local Development Setup

Prerequisites

Node.js

pnpm

Supabase CLI

Xcode

1. Clone the Repositories

2. Setup Supabase Backend

3. Setup Web Store

4. Setup iOS App (Mac only)

Test Data

Verify Setup

Troubleshooting

​Prerequisites

Node.js

pnpm

Supabase CLI

Xcode

​1. Clone the Repositories

​2. Setup Supabase Backend

​3. Setup Web Store

​4. Setup iOS App (Mac only)

​Test Data

​Verify Setup

​Troubleshooting

Prerequisites

1. Clone the Repositories

2. Setup Supabase Backend

3. Setup Web Store

4. Setup iOS App (Mac only)

Test Data

Verify Setup

Troubleshooting