Skip to content

Design/ux v1#2

Merged
mayur-tolexo merged 22 commits into
mainfrom
design/ux-v1
May 23, 2026
Merged

Design/ux v1#2
mayur-tolexo merged 22 commits into
mainfrom
design/ux-v1

Conversation

@mayur-tolexo

Copy link
Copy Markdown
Owner

No description provided.

- compose.yaml runs postgres 16 (host port 5433 to avoid agent-platform clash)
  + redis 7 with healthchecks and named volumes.
- Makefile auto-loads .env so run-api / migrate-up / etc. work without a
  manual `export $(grep ...)` step.
- `make up` is detached: builds binaries, brings up infra, applies migrations,
  starts both go services in the background, polls /health until healthy,
  then returns to the prompt. PIDs in .pids/, logs in .logs/ (gitignored).
- `make down` stops go services via PID files (with pkill fallback) and runs
  docker compose down.
- `make logs` tails both go service logs interleaved; `make logs-infra`
  tails compose; `make ps` shows everything in one view.
- shoplit-redirect dev DSN points at the same shoplit user as the API; the
  prod-only readonly role is provisioned during deployment (Plan 5).
Locks the design direction for the frontend milestone (Plan 5 pulled
forward):
- editorial / magazine mood (LTK + Pinterest + Glossier reference)
- minimal customization per cart (cover image + accent color + bio)
- vertical stack of large product cards on /c/{slug}, 2-col at ≥768px
- mobile-first; light theme only in v1
- Next.js 14 + Tailwind + shadcn/ui + Fraunces/Inter
- 7 pages designed: /, /login, /dashboard, /dashboard/carts/new,
  /dashboard/carts/[id], /c/{slug}, /legal/*
- mocked data layer (lib/api-client.ts ⇄ lib/mocks.ts) so real backend
  wiring in later plans is a one-file swap

Spec sits alongside the architecture spec; complements rather than
replaces it.
Bootstrap Next.js 14 in web/ → tokens + fonts + shadcn → typed mocks
+ api-client → shared components → 7 pages → final verification with
Lighthouse + axe a11y.

Each task is self-contained with full code blocks; the design spec
remains the source of truth for visual details.
- start.sh now launches `pnpm dev` from web/ alongside the two go
  services; auto-runs `pnpm install` on first run if node_modules
  is missing. Polls /:3000 with a 30s timeout (vs 8s for go) to
  account for next.js cold-start compile.
- stop.sh kills the web pid + pkills any stray `next dev` /
  `next-server` processes as a fallback.
- Makefile: new `run-web` and `web-install` targets for ad-hoc use;
  logs/ps now include web; help text updated.
- README: Node + pnpm added to prerequisites; workflow rewritten to
  mention http://localhost:3000 as the entry point.

Verified end-to-end: make up brings all three services to HTTP 200
within ~5s; make down stops cleanly with no orphan node/go processes.
@mayur-tolexo
mayur-tolexo merged commit 1a1ff03 into main May 23, 2026
1 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant