Setup
Local Run
Run Localess locally for development or to try it out without any cloud infrastructure.
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 v20 or later
- npm v10 or later (bundled with Node.js)
- Java 11 or later (required by Firebase Emulators)
- Firebase CLI v13 or later
Install the Firebase CLI if you haven't already:
npm install -g firebase-toolsClone the repository
git clone https://github.com/Lessify/localess.git
cd localessInstall dependencies
npm installStart the emulators
Localess uses Firebase Emulators to run all backend services locally:
npm run emulatorsThis starts the following emulators:
| Emulator | Port |
|---|---|
| Hosting | 5000 |
| Auth | 9099 |
| Functions | 5001 |
| Firestore | 8080 |
| Storage | 9199 |
Start the development server
In a separate terminal, start the Angular dev server:
npm run startOpen http://localhost:4200 in your browser.
First start
On the first run you will need to create an admin account. Navigate to the setup page:
http://localhost:4200/setupFollow the on-screen instructions to create your first user and space.