{"id":51012327,"url":"https://github.com/justyn-clark/nestjs-react-router","last_synced_at":"2026-06-21T04:31:34.929Z","repository":{"id":355954034,"uuid":"1067655540","full_name":"justyn-clark/nestjs-react-router","owner":"justyn-clark","description":"A modern, production-ready monorepo combining NestJS backend with React Router 7 frontend, featuring server-side rendering, client-side navigation, and enterprise-grade architecture. Built with TypeScript, Fastify, Drizzle ORM, Redis, and Tailwind CSS.","archived":false,"fork":false,"pushed_at":"2026-05-06T00:49:15.000Z","size":629,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-06T02:33:39.975Z","etag":null,"topics":["backend","drizzle-orm","fastify","full-stack","monorepo","nestjs","nodejs","postgresql","production-ready","react","react-router","redis","server-side-rendering","ssr","tailwindcss","turborepo","typescript","vite","web-framework"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/justyn-clark.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-01T07:25:16.000Z","updated_at":"2026-05-06T00:49:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/justyn-clark/nestjs-react-router","commit_stats":null,"previous_names":["justyn-clark/nestjs-react-router"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/justyn-clark/nestjs-react-router","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justyn-clark%2Fnestjs-react-router","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justyn-clark%2Fnestjs-react-router/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justyn-clark%2Fnestjs-react-router/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justyn-clark%2Fnestjs-react-router/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/justyn-clark","download_url":"https://codeload.github.com/justyn-clark/nestjs-react-router/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/justyn-clark%2Fnestjs-react-router/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34594326,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["backend","drizzle-orm","fastify","full-stack","monorepo","nestjs","nodejs","postgresql","production-ready","react","react-router","redis","server-side-rendering","ssr","tailwindcss","turborepo","typescript","vite","web-framework"],"created_at":"2026-06-21T04:31:34.290Z","updated_at":"2026-06-21T04:31:34.924Z","avatar_url":"https://github.com/justyn-clark.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# NestJS React Router\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/justyn-clark/nestjs-react-router/actions/workflows/ci.yml\"\u003e\u003cimg alt=\"CI\" src=\"https://img.shields.io/github/actions/workflow/status/justyn-clark/nestjs-react-router/ci.yml?branch=main\u0026label=ci\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/justyn-clark/nestjs-react-router/releases\"\u003e\u003cimg alt=\"Release\" src=\"https://img.shields.io/github/v/release/justyn-clark/nestjs-react-router?display_name=tag\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/justyn-clark/nestjs-react-router/tags\"\u003e\u003cimg alt=\"Tag\" src=\"https://img.shields.io/github/v/tag/justyn-clark/nestjs-react-router\"\u003e\u003c/a\u003e\n  \u003ca href=\"./LICENSE\"\u003e\u003cimg alt=\"License\" src=\"https://img.shields.io/github/license/justyn-clark/nestjs-react-router\"\u003e\u003c/a\u003e\n  \u003ca href=\"#quick-start\"\u003e\u003cimg alt=\"Stack\" src=\"https://img.shields.io/badge/stack-NestJS%20%7C%20React%20Router%207%20%7C%20PostgreSQL%20%7C%20Redis-0f172a\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/logos/nestjs-logo.svg\" alt=\"NestJS Logo\" width=\"120\" height=\"120\"/\u003e\n  \u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;\n  \u003cimg src=\"assets/logos/rr_logo_light.svg\" alt=\"React Router Logo\" width=\"120\" height=\"120\"/\u003e\n\u003c/p\u003e\n\n\nA truthful, opinionated starter where NestJS 11 hosts and renders a React Router 7 app with SSR, React 19, PostgreSQL persistence, Redis-backed state, and shared workspace packages.\n\n\u003c/div\u003e\n\n## Why this starter\n\nUse this if you want:\n- one Nest-hosted full-stack app instead of a fake split frontend/backend setup\n- SSR with React Router 7\n- PostgreSQL via Drizzle\n- Redis-backed sessions and queue wiring\n- deterministic verification that is friendly to both humans and agents\n\n## Why it saves work\n\nThis starter packages roughly 778k fresh agent-work tokens of solved product and integration work. Starting here means you do not have to spend that work rediscovering the NestJS/React Router seams, workspace wiring, docs, and verification loop from scratch.\n\nSee `docs/token-estimate.md` for the detailed estimate and caveats.\n\n## What it includes\n\n- NestJS 11 on Fastify 5\n- React 19 + React Router 7 SSR bridge\n- pnpm workspace + Turborepo layout\n- route-module manifest pattern for feature-oriented routing\n- PostgreSQL package with Drizzle schema and helpers\n- Redis-backed sessions\n- BullMQ demo queue wiring\n- contact submission flow persisted to PostgreSQL\n- health endpoint covering Redis and PostgreSQL\n- CI, devcontainer config, and release docs\n- end-to-end smoke coverage against a running built app\n- a tech stack map for modern and agent-legible application building\n- a starter control plane with slash-command palette, activity feed, task runs, and realtime events\n\n## Intentional seams\n\nThis starter is publishable and usable, but it stays honest about what is still demo-level:\n- auth is demo auth, not a production identity system\n- queue processing is demo scaffolding\n\n## Quick start\n\n### Local services already available\n\n```bash\ncp .env.example .env\npnpm install\npnpm db:push\npnpm dev\n```\n\nOpen `http://localhost:3000`.\n\n`pnpm db:push` will create the `DATABASE_URL` database when it does not exist and the configured Postgres user has `CREATEDB` permission. With hosted or restricted Postgres users, create the database manually first and then run `pnpm db:push`.\n\n### Compose-backed path\n\nIf ports `3000`, `5432`, or `6379` are already occupied:\n\n```bash\ncp .env.example .env\nexport NRR_APP_PORT=3300\nexport NRR_POSTGRES_PORT=55432\nexport NRR_REDIS_PORT=56379\npnpm docker:up\nDATABASE_URL=postgres://postgres:postgres@localhost:${NRR_POSTGRES_PORT}/appdb pnpm db:push\npnpm start\n```\n\nOpen `http://localhost:${NRR_APP_PORT}`.\n\n### Full compose app container\n\n```bash\nexport NRR_APP_PORT=3300\nexport NRR_POSTGRES_PORT=55432\nexport NRR_REDIS_PORT=56379\npnpm docker:up:build\n```\n\n## Verify it\n\n```bash\npnpm verify\npnpm start\npnpm test:e2e\n```\n\n## Runtime shape\n\nThis is one Nest-hosted full-stack application.\n\n- Nest handles API routes, auth/session endpoints, and SSR orchestration\n- React Router is rendered and served through Nest\n- client assets are served from the built web output\n\nIt is not two independently deployed apps pretending to be one product.\n\n## Main routes and endpoints\n\nThe web shell now includes a small control-plane layer:\n- slash-command palette\n- realtime activity feed\n- task/run surface\n- app-native control actions such as enqueueing the demo job\n- PostgreSQL-backed persistence for recent task runs and activity events\n\n\nBrowser routes:\n- `/`\n- `/stream`\n- `/contact`\n- `/dashboard`\n- `/test`\n\nHTTP endpoints:\n- `GET /api/health`\n- `GET /api/control-plane/summary`\n- `GET /api/control-plane/events`\n- `POST /api/contact`\n- `GET /api/session-debug`\n- `GET /api/queue/add`\n- `POST /auth/login`\n- `POST /auth/logout`\n- `GET /auth/me`\n\n## Commands\n\n```bash\npnpm dev\npnpm start\npnpm verify\npnpm start\npnpm test:e2e\npnpm db:push\npnpm docker:up\npnpm docker:up:build\npnpm docker:down\n```\n\n## Read next\n\n- Architecture: `docs/architecture.md`\n- Local development: `docs/local-development.md`\n- Agent legibility: `docs/agent-legibility.md`\n- Token estimate note: `docs/token-estimate.md`\n- Tech stack map: `docs/tech-stack-map.md`\n- Release checklist: `docs/release-checklist.md`\n- Route notes: `apps/web/src/routes/README.md`\n- Secrets guidance: `SECRETS_POLICY.md`\n\n## License\n\nMIT. See `LICENSE`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustyn-clark%2Fnestjs-react-router","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjustyn-clark%2Fnestjs-react-router","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjustyn-clark%2Fnestjs-react-router/lists"}