Development environment setup

[michaelwschultz]

Summary

Sets up the Hemolog development environment and documents the configuration so Cursor and other developers can restore it in future sessions.

Changes

• Added .env.example – Documents required environment variables for local development with Firebase emulators:

  • NEXT_PUBLIC_USE_EMULATORS=true – Enables local Firebase emulators
  • NEXT_PUBLIC_FIREBASE_PROJECT_ID=hemolog – Project ID (optional, has fallback)
  • Optional Firebase API keys for production use

• Updated .cursorrules – Added "Development Environment Setup" section with step-by-step instructions:

  1. pnpm install
  2. Create .env.local from .env.example (ensure NEXT_PUBLIC_USE_EMULATORS=true)
  3. Terminal 1: pnpm run firebase
  4. Terminal 2: pnpm run dev
  5. Verify at http://localhost:3000 and http://localhost:8081

  This allows Cursor agents to restore and run the dev environment in future sessions without re-discovering the setup.

• Created .env.local (local only, gitignored) – Configured for emulator mode during setup verification

Setup Verification

The development environment has been verified to work:

1. Dependencies – pnpm install completed successfully (1022 packages)
2. Firebase Emulators – pnpm run firebase starts Auth (9099), Firestore (8082), and Emulator UI (8081)
3. Next.js Dev Server – pnpm run dev starts the app at http://localhost:3000
4. Application – Hemolog landing page loads correctly
5. Emulator UI – Firebase Emulator Suite accessible at http://localhost:8081

  

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
hemolog-com	Error		Mar 14, 2026 7:41am