⚡ 5-Minute Quickstart

Pick a repository, use its pinned toolchain, run its checks, then start locally.

Choose a path

Work	Guide
Flutter app	Frontend developer
Firebase Functions/API	API reference
Production operations	Operator
Incident diagnosis	Debugging
Documentation	Contributing

The GPU backend has its own repository guide and is outside this quickstart's verified scope.

One-time tools

• Flutter 3.41.9 for acesense-frontend
• Node.js 22 for Cloud Functions; Node.js 20+ for the web/docs projects
• pnpm 9 where a repository has a pnpm-lock.yaml
• Firebase CLI authenticated to acesense-prod

firebase login
firebase projects:list
firebase use acesense-prod

Fast smoke checks

# Flutter
cd acesense-frontend
flutter pub get
flutter analyze --no-fatal-infos
flutter test
flutter run -d chrome

# Cloud Functions
cd ../acesense-auth-function
pnpm install --frozen-lockfile
pnpm lint && pnpm test && pnpm build

# Docs
cd ../acesense-docs/website
pnpm install --frozen-lockfile
pnpm test
pnpm start

Do not point local clients at production writes by accident. Admin uses Firebase emulators by default in local development; check each repository's environment flags before testing data mutations.

Related

• Architecture
• Configuration
• Troubleshooting