Prerequisites
Install and verify the following before cloning the repository.
Operating system
| OS | Supported versions |
|---|---|
| Windows | Windows 10 or later (64-bit) |
| macOS | macOS 12 (Monterey) or later |
| Linux | Ubuntu 20.04+, Debian 11+, Fedora 38+, or equivalent |
Required software
Node.js
| Component | Minimum | Recommended |
|---|---|---|
| Node.js | 18.0.0 | 20.x LTS |
| npm | 9.0.0 | 10.x (bundled with Node 20) |
Verify installation:
node --version
# v20.x.x
npm --version
# 10.x.x
Download: https://nodejs.org/
Git
| Component | Minimum |
|---|---|
| Git | 2.30+ |
git --version
Download: https://git-scm.com/downloads
Code editor (recommended)
- Visual Studio Code with ESLint and TypeScript extensions
Firebase account
You need a Google account and a Firebase project:
- Go to Firebase Console
- Create a new project (e.g.
asset-management-prod) - Enable Authentication → Email/Password (minimum)
- Create Cloud Firestore database (production or test mode for development)
- Register a Web app and copy the config object
Firebase CLI (for deployment)
Required for deploying Firestore rules and hosting:
npm install -g firebase-tools
firebase --version
firebase login
Browser requirements
| Browser | Minimum version |
|---|---|
| Google Chrome | 100+ |
| Microsoft Edge | 100+ |
| Mozilla Firefox | 100+ |
| Safari | 15+ |
WebAuthn (passkeys) requires HTTPS in production or localhost in development.
Network
- Outbound HTTPS to
*.googleapis.com,*.firebaseio.com, and Firebase Auth domains - Port 3000 available for local dev server (configurable in
vite.config.ts)
Hardware (development)
| Resource | Minimum |
|---|---|
| RAM | 8 GB |
| Disk | 500 MB free (excluding node_modules) |
| CPU | Dual-core |
Optional
| Tool | Purpose |
|---|---|
| Firebase Emulator Suite | Local Auth/Firestore testing |
| Java JDK 11+ | Some Firebase emulator features |