Getting Started

By the end of this tutorial you will have Kredal running locally against a Supabase project, able to sign up, create a company, and run a readiness assessment.

Prerequisites

• Node.js 20+ (developed on v24). Check with node -v.
• The Supabase CLI (supabase -v). Install: supabase.com/docs/guides/cli.
• A Supabase project. If you do not have one, follow Apply DB migrations first — it creates and migrates one.

1. Install dependencies

cd kredal-app
npm install

2. Configure environment variables

Copy the example file and fill in your Supabase project's values:

cp .env.local.example .env.local

.env.local needs three values (see Environment variables):

To pull these safely from the CLI without printing them, see Rotate Supabase keys.

.env.local is gitignored. Never commit it. Never prefix the service-role key with NEXT_PUBLIC_ — that would leak it to the browser.

3. Run the dev server

npm run dev

Open localhost:3000. You should see the landing page.

4. Walk the founder journey

1. Click Get started and create an account.
2. Create your first workspace (single company or consultant).
3. Add a company with its trade license details.
4. Upload documents against the checklist.
5. Complete the readiness questionnaire (8 sections).
6. Run the rejection-risk assessment — you get a score, risk flags, and fixes.
7. Generate a report (founder readiness report or bank application pack).

Next steps

• Seed demo data to skip manual entry with a realistic example.
• Run the tests.
• Understand why the product exists.