Feature File Map

Use this document to find the first files to inspect for common Compass changes.

App Boot And Routing

Frontend bootstrap: packages/web/src/index.tsx
App provider tree: packages/web/src/components/App/App.tsx
Root authenticated shell: packages/web/src/views/Root.tsx
Router config: packages/web/src/routers/index.tsx
Router loaders: packages/web/src/routers/loaders.ts
Client version polling: packages/web/src/components/Sidebar/SidebarActions/useVersionCheck.ts
Update CTA wiring: packages/web/src/components/Sidebar/SidebarActions/SidebarActions.tsx

Session initialization and SuperTokens wiring: packages/web/src/auth/session/SessionProvider.tsx
User profile bootstrap: packages/web/src/auth/context/UserProvider.tsx
Google authorization app flow: packages/web/src/auth/google/authorization
Google redirect callback: packages/web/src/views/GoogleAuthCallback/GoogleAuthCallback.tsx
Google authorization intent storage: packages/web/src/auth/google/authorization/google-authorization.storage.ts
Auth schemas: packages/web/src/auth/schemas/auth.schemas.ts
Backend auth routes: packages/backend/src/auth/auth.routes.config.ts
Backend auth controllers/services: packages/backend/src/auth/controllers, packages/backend/src/auth/services

Shared event schema/types: packages/core/src/types/event.contracts.ts
Event helpers and recurrence utilities: packages/core/src/util/event
Web Event reads, cache utilities, and view models: packages/web/src/events/queries
Web Event persisted mutations and pending state: packages/web/src/events/mutations
Web Event draft/interaction Zustand state: packages/web/src/events/stores/draft.store.ts
Event API/repositories: packages/web/src/events/event.api.ts, packages/web/src/events/repositories
Backend event routes: packages/backend/src/event/event.routes.config.ts
Backend event controller/service: packages/backend/src/event/controllers/event.controller.ts, packages/backend/src/event/services/event.service.ts

Day view route and content: packages/web/src/views/Day/view
Day view header (includes sidebar toggle control): packages/web/src/views/Day/components/Header/Header.tsx
Day keyboard shortcuts (includes [ toggle): packages/web/src/views/Day/hooks/shortcuts/useDayViewShortcuts.ts
Day view hooks: packages/web/src/views/Day/hooks
Week view: packages/web/src/views/Week
Responsive layout controller (auto-collapse on breakpoint crossings): packages/web/src/components/AuthenticatedLayout/useResponsiveLayout.ts
Dedication dialog implementation (native dialog + hotkeys): packages/web/src/views/Week/components/Dedication/Dedication.tsx
Dedication dialog mount points:
- week view: packages/web/src/views/Week/WeekView.tsx
- day view: packages/web/src/views/Day/view/DayViewContent.tsx

Shared sidebar shell: packages/web/src/components/Sidebar/Sidebar.tsx
Month picker: packages/web/src/components/Sidebar/MonthPicker/MonthPicker.tsx
Account identity/sync indicator: packages/web/src/components/Sidebar/CalendarList/CalendarListHeader.tsx
Sidebar actions and shortcuts overlay: packages/web/src/components/Sidebar/SidebarActions/SidebarActions.tsx, packages/web/src/components/Sidebar/ShortcutsOverlay/ShortcutsOverlay.tsx
Week mount point: packages/web/src/views/Week/WeekView.tsx
Day mount point: packages/web/src/views/Day/view/DayViewContent.tsx

Offline data store singleton and readiness: packages/web/src/common/storage/offline-data/offline-data.store.registry.ts
IndexedDB implementation: packages/web/src/common/storage/offline-data/indexeddb-offline-data.store.ts
Legacy schema migration: packages/web/src/common/storage/offline-data/legacy-primary-key.migration.ts
Data/external migrations: packages/web/src/common/storage/migrations
Browser key-value state: packages/web/src/common/storage/browser-key-value.store.ts

SSE client: packages/web/src/sse/client/sse.client.ts
SSE hooks: packages/web/src/sse/hooks
SSE provider: packages/web/src/sse/provider/SSEProvider.tsx
Shared SSE event names: packages/core/src/constants/sse.constants.ts
Backend SSE server: packages/backend/src/servers/sse/sse.server.ts
Events stream route: packages/backend/src/events/events.routes.config.ts
Backend sync routes: packages/backend/src/sync/sync.routes.config.ts
Public watch notification ingress: packages/backend/src/sync/services/public-watch-notifications/public-watch-notification.ingress.ts
Google Watch lifecycle and notifications: packages/backend/src/sync/services/watch
Google Calendar sync import and repair: packages/backend/src/sync/services/google-sync/google-sync.service.ts
Google sync health diagnosis: packages/backend/src/sync/services/google-sync/google-sync.health.ts
Compass-to-Google repair mirroring: packages/backend/src/sync/services/event-propagation/compass-to-google/compass-to-google-backfill.ts
Sync record persistence: packages/backend/src/sync/services/records/sync-records.repository.ts
Google import internals: packages/backend/src/sync/services/import
Google/Compass event propagation: packages/backend/src/sync/services/event-propagation

User queries/services: packages/backend/src/user
User metadata service: packages/backend/src/user/services/user-metadata.service.ts
Mobile waitlist gate (web-only external link): packages/web/src/components/MobileGate/MobileGate.tsx

Backend env parsing: packages/backend/src/common/constants/env.constants.ts
Web env parsing: packages/web/src/common/constants/env.constants.ts
Express middleware order: packages/backend/src/servers/express/express.server.ts
Health endpoint route/controller/tests: packages/backend/src/health/health.routes.config.ts, packages/backend/src/health/controllers/health.controller.ts, packages/backend/src/health/controllers/health.controller.test.ts

Mongo-backed test launcher (per-file isolation over one in-memory replica set): packages/scripts/src/testing/run-tests.ts
Bun/Jest compatibility shim used by every package's tests: packages/scripts/src/testing/apply-bun-jest-compat.cjs
Core test setup: packages/core/src/__tests__
Web test setup: packages/web/src/__tests__
Web mock server handlers: packages/web/src/__tests__/__mocks__/server/mock.handlers.ts
Web floating-ui test setup: packages/web/src/__tests__/floating-ui.setup.ts
Web memory-router test helper: packages/web/src/__tests__/utils/providers/MemoryRouter.tsx
Backend test setup: packages/backend/src/__tests__
E2E tests: e2e