SpokeToWork - Job Hunting by Bicycle

Track companies, plan bicycle routes, find work locally.

Try it →

What It Does

Feature	Description
🏢 Track Companies	Maintain target employers with status, priority, contacts
🚴 Plan Routes	Optimized bicycle routes connecting multiple companies
💬 Secure Messages	End-to-end encrypted communication
📅 Schedule	Calendar integration for interviews
📱 Works Offline	PWA that syncs when back online

Quick Links

• App: SpokeToWork.com
• Storybook: SpokeToWork.com/storybook
• Status: SpokeToWork.com/status

Tech Stack

Next.js 15 • React 19 • TypeScript • Tailwind CSS 4 • Supabase • PWA

For Contributors

Docker required. All commands run inside container.

docker compose up                           # Start dev
docker compose exec spoketowork pnpm test   # Run tests

See CLAUDE.md for full development documentation.

Lighthouse Scores

Performance 92 • Accessibility 98 • Best Practices 95 • SEO 100 • PWA 92

Technical Debt

053 - Unified Browser Event Hooks ✅ COMPLETE

Duplicate event listeners (online/offline, click-outside, visibility). Consolidate into hooks. Created useOnlineStatus, useClickOutside, useVisibilityChange hooks. Migrated 3 components. View Spec

054 - Code Consolidation ✅ COMPLETE

Duplicate implementations (offline queue, audit logger, email validation, rate limiter). All consolidated: offline queue has adapters, email validation delegates to auth, dead code removed. View Spec

055 - Test Coverage Expansion ✅ COMPLETE

[View Spec](specs/055-test-coverage/spec.md)

---

All P1/P2 technical debt specs complete. See docs/TECHNICAL-DEBT.md for future items.

E2E Test Remediation

Status: 125 unique failures (27 CRITICAL, 65 HIGH, 24 MEDIUM, 9 LOW)

Root Causes:

• AUTH_FAILURE (51%): Tests show "Sign In" link when authenticated state expected
• STATE_DEPENDENT (26%): Tests assume data from previous runs
• OVERLAY_BLOCKING (16%): Cookie consent banner visible in 95% of failures

Analysis Report: docs/specs/e2e-remediation/analysis-report.md

To start the remediation workflow:

/speckit.workflow Fix E2E test failures: 27 CRITICAL (auth failures blocking 51% of tests), 65 HIGH (feature-specific). Primary root cause is authentication not persisting - tests show "Sign In" link when auth expected. Secondary issue is cookie banner blocking 95% of tests. See docs/specs/e2e-remediation/analysis-report.md

Design System Redesign

Custom SpokeToWork theme (dark default + light variant) built on the existing DaisyUI/Tailwind stack. Storybook upgrade to v10, then bottom-up component reskin.

Design doc: docs/plans/2026-02-13-design-system-redesign.md Implementation plan: docs/plans/2026-02-13-design-system-implementation.md

Session Continuation Prompt

Read these files to pick up the design system redesign:

1. CLAUDE.md - Project rules, Docker setup, coding standards
2. docs/plans/2026-02-13-design-system-redesign.md - Approved design (colors, aesthetic, constraints)
3. docs/plans/2026-02-13-design-system-implementation.md - Task-by-task plan
4. docs/STORYBOOK_NOTES.md - Current Storybook state (needs v10 upgrade)
5. src/app/globals.css - Current theme config, DaisyUI plugin block, typography system

Use superpowers:executing-plans to work through the implementation plan.
Start at Phase 1 Task 1 (or wherever the plan left off).

Key context:
- Everything runs inside Docker: docker compose exec spoketowork <command>
- pnpm, not npm
- DaisyUI beta with Tailwind v4 CSS-first config (@plugin syntax)
- Brand colors: orange #E67E22 (primary), cyan #00d9ff (secondary), green #22c55e (accent), navy #132a4e (base)
- Dark theme default, light variant available
- Preserve all existing accessibility work (WCAG touch targets, ARIA patterns, colorblind filters)
- Aesthetic: mission with personality. Headspace-like. Not silly, not corporate.

License

MIT - See LICENSE