work-with

Map-first product for finding and posting workout-partner opportunities.

Demo: Vite + React + TS

The current hosted deployment is client-only on vercel.

Product direction

• Keep the map as the primary discovery surface.
• Help people find nearby workout partners without turning the product into a social feed.
• Preserve lightweight, low-pressure interactions.
• Improve trust, clarity, and responsiveness without changing the product thesis.

Current status

• Home is the map-first entry page with linked map, list, and detail discovery states.
• /find is a dedicated condition-based discovery page with its own filters and comparison flow.
• /regist is a staged posting flow with required-field validation, a pre-submit summary, and a success state.
• The backend exposes a Kakao suggest proxy plus app-owned POST /api/login, GET /api/work-with/locations/:locationId, and POST /api/work-with routes.
• Auth currently uses fixed demo credentials, and work-with storage is still in-memory demo data.

Tech stack

• Frontend: Vite, React, TypeScript, Recoil, Tailwind CSS, axios, react-kakao-maps-sdk
• Backend: Express, TypeScript, postgres
• Tooling: ESLint, Jest, concurrently

Local development

Install

yarn
yarn --cwd client
yarn --cwd server

Recommended workflow

yarn start

• yarn start runs the client and server together from the repository root.
• yarn client starts only the frontend dev server.
• yarn server starts only the backend dev server.

Validation

yarn run check

Individual validation commands:

• yarn client:lint
• yarn client:build
• yarn client:test
• yarn server:build

Docker Compose note

docker-compose.dev.yaml does not mirror the full root dev workflow.

• It currently manages postgres and the client container.
• It does not start the Node server.
• If you use Docker Compose for local infrastructure, run the backend separately with yarn --cwd server dev.

Example:

docker compose -f docker-compose.dev.yaml up --build postgres client

Project references

• AGENTS.md
• docs/product-invariants.md
• docs/toss-inspired-ui-spec.md
• docs/user-flows.md
• docs/milestones.md
• progress/current.md