Local Run

Running Localess locally is the fastest way to explore features, develop integrations, or contribute to the project — no cloud account required.

For a quick preview without cloning the repository, see the Docker setup instead.

Prerequisites

• Node.js 24 (pinned in the repository's package.json)
• npm v10 or later (bundled with Node.js)
• Java 21 or later (required by the Firebase Emulators)
• Firebase CLI 15.29.0 or later

Install the Firebase CLI if you haven't already:

npm install -g firebase-tools@latest

Clone the repository

git clone https://github.com/Lessify/localess.git
cd localess

Install dependencies

npm install

Cloud Functions are a separate package and must be built before the emulator can load them:

cd functions
npm install
npm run build
cd ..

Start the emulators

Localess uses Firebase Emulators to run all backend services locally:

npm run emulator

This starts the following emulators:

Start the development server

In a separate terminal, start the Angular dev server:

npm run start

Open http://localhost:4200 in your browser.

First start

There is no setup page. Create your first admin once, in the Firebase Emulator UI:

1. Open http://localhost:4000 and go to Authentication.
2. Add user with an email and password.
3. Edit the user and set its custom claims to {"role":"admin"}.

Sign in to Localess at http://localhost:4200 with that account, then create your first space. The emulator exports its state to firebase-export on exit, so the account survives restarts.