Quick Start & Installation

1. Clone Repository#

Clone the LaterBox monorepo to your local machine:

git clone https://github.com/Chaste-Djaziri/laterbox.git
cd laterbox

2. Start Supabase (Local or Cloud)#

Option A: Local Docker Stack (Recommended for offline development)

# Start local PostgreSQL, GoTrue, Realtime, and Storage in Docker
supabase start

# Apply SQL migrations and RLS policies
supabase db reset

Option B: Cloud Supabase Project

1. Create a free project on [supabase.com](https://supabase.com).
2. Link your local CLI:

   supabase link --project-ref your-project-id
   supabase db push

3. Run Next.js Web App#

Navigate to laterbox-web/, install dependencies, and start the Turbopack dev server:

cd laterbox-web
npm install

# Copy sample environment variables
cp .env.example .env.local

# Start development server on port 3000
npm run dev

Open [http://localhost:3000](http://localhost:3000) in your browser. You can test the app in Guest Sandbox Mode immediately or sign in with your Supabase credentials.

4. Run Flutter Desktop & Mobile#

In the root repository directory, fetch Flutter dependencies and start the app:

# Fetch Dart & Flutter dependencies
flutter pub get

# Run on macOS Desktop
flutter run -d macos

# Run on Windows Desktop
flutter run -d windows

# Run on Linux Desktop
flutter run -d linux

# Run on iOS Simulator or Android Emulator
flutter run -d ios
flutter run -d android

5. Build Browser Extensions#

Navigate to extension/ to compile the Manifest V3 extension bundle:

cd extension
npm install

# Build extension packages
npm run package

To load the extension into your browser:

1. Open Chrome and navigate to chrome://extensions/.
2. Toggle on Developer mode in the top right.
3. Click Load unpacked and select the extension/dist/chromium/ folder.