Skip to Content
DocumentationFrontendLocal Development

Local Development

Use these steps to run howden-client locally.

Prerequisites

  • Node.js v20.x
  • pnpm 9.x
  • A running local be-howden API

Setup

  1. Start the backend first.

    Follow be-howden/docs/LOCAL_DEVELOPMENT.md and make sure the API is available at:

    http://localhost:8000
  2. Go to the client directory.

    cd howden-client
  3. Install dependencies.

    pnpm install
  4. Create or update the local .env file in the howden-client root.

    For local development, point the client to the local backend:

    NODE_ENV=development NEXT_PUBLIC_API_ENDPOINT=http://localhost:8000 NEXT_PUBLIC_RECAPTCHA_SITE_KEY=your-local-site-key NEXT_PUBLIC_RECAPTCHA_SECRET_KEY=your-local-secret-key NEXTAUTH_SECRET=your-local-nextauth-secret

    Keep any existing valid local values for reCAPTCHA and authentication secrets.

  5. Start the Next.js development server.

    pnpm dev
  6. Open the client in your browser.

    http://localhost:3000

Useful Commands

pnpm dev pnpm build pnpm lint pnpm type-check pnpm test

Stop Local Development

Stop the client process with Ctrl+C.

Last updated on