Blueprint Navigator is a frontend-only proof-of-concept with a project dashboard that lets teams create projects, upload plan PNG/PDF files per project, and run typed/voice plan search across all projects.

• No backend service
• No external database
• Browser persistence with IndexedDB (Dexie)
• Temporary container filesystem path at /app/tmp
• Run locally with Docker Compose + Bun

docker compose up --build

App URL (default): http://localhost:5174 Override host port: APP_PORT=5173 docker compose up --build Note: container startup runs bun install inside the app container volume.

bun install
bun run dev

To enable LLM-assisted query parsing (for text search) and Whisper transcription (for voice search), set:

• VITE_OPENAI_API_KEY
• VITE_OPENAI_MODEL (default: gpt-4o-mini)
• VITE_OPENAI_WHISPER_MODEL (default: whisper-1)

See .env.example for the full list.

• bun run dev
• bun run build
• bun run preview
• bun run test
• bun run test:watch
• bun run test:e2e

src/
  app/
  components/
  features/
    drawings/
    pdf/
    search/
    storage/
    voice/
  test/
public/
  branding/
  favicon/
docs/

• Task Breakdown
• Architecture Notes

Voice search uses microphone recording plus OpenAI Whisper transcription. Browser support requires MediaRecorder and microphone permissions.