Handelsregister App

Appearance

Developer Onboarding ​

Prerequisites and setup guide for team members joining the Handelsregister app development.

Required Tools ​

Node.js & npm ​

Required for: Frontend development, workspace management

Installation:

  • Download from: https://nodejs.org/ (LTS version recommended)
  • Verify: node --version and npm --version

Homebrew (macOS only) ​

Required for: Installing Supabase CLI

Installation:

bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Verify: brew --version

Supabase CLI ​

Required for: Local database development, migrations, type generation

Installation:

bash
brew install supabase/tap/supabase

Verify: supabase --version

Note: npm global install is not supported and will fail.

Docker Desktop ​

Required for: Local database containers

Installation:

Why needed: Local development runs PostgreSQL in Docker containers.

Developer Setup ​

1. Clone Repository ​

bash
git clone <repository-url>
cd handelsregister-app

2. Install Dependencies ​

bash
npm install

Why needed: Downloads all required packages for running database scripts and development tools.

3. Authenticate with Supabase ​

bash
supabase login

Opens browser for authentication with your Supabase account.

4. Connect to Project ​

bash
supabase link --project-ref YOUR_PROJECT_ID

Get project ID from team lead or find it in:

  • Supabase Dashboard URL: https://supabase.com/dashboard/project/YOUR_PROJECT_ID
  • Project Settings → Reference ID

5. Start Local Development ​

bash
supabase db start

Expected output:

Started supabase local development setup.
 API URL: http://127.0.0.1:54321
 Studio URL: http://127.0.0.1:54323
 DB URL: postgresql://postgres:postgres@127.0.0.1:54322/postgres

6. Initialize Database with Sample Data ​

bash
npm run db:reset

Why needed: Populates the local database with sample data and applies all migrations for a complete development environment.

Test: Open http://127.0.0.1:54323 to see Supabase Studio with project schemas and sample data.

Database Reset ​

If you need to reset your local database:

bash
supabase db reset
npm run db:reset