redwoodjs/redwood

The repository contains framework packages, generated application templates, integration fixtures, task tooling, and a separate Docusaurus documentation application. Application runtime boundaries divide browser rendering from API execution, with Prisma clients owned by applications. Fastify hosts ordinary functions and a dedicated GraphQL Yoga integration, while a separate handler adapts Yoga to Lambda events. Root scripts coordinate package builds and tests through Nx; package manifests define the published entrypoints.

• The root is a private Yarn 4.6.0 workspace covering framework packages, adapters, authentication providers, CLI packages, and mailer components; create-redwood-rsc-app is explicitly excluded from that workspace list.
  package.json#L1-13package.json#L137-138
• Root build, test, test-ci, and test:types scripts dispatch Nx targets; tsconfig.json references internal, structure, API, server, auth, web, router, testing, prerender, GraphQL, forms, and codemod projects.
  package.json#L14-48tsconfig.json#L1-16
• The CLI publishes rw and redwood binaries from dist/index.js; source startup resolves --cwd, RWJS_CWD, or the nearest redwood.toml before loading application environment files.
  packages/cli/package.json#L11-18packages/cli/src/index.js#L74-107
• The browser entrypoint imports application root and routes through ~redwood aliases, then selects hydrateRoot for existing markup or createRoot for an empty redwood-app element.
  packages/web/src/entry/index.jsx#L1-29
• createServer constructs Fastify, creates request-scoped context, registers the generic API adapter, and separately imports compiled GraphQL options to register a Yoga server.
  packages/api-server/src/createServer.ts#L105-146
• createGraphQLYoga owns schema assembly and an ordered Envelop plugin chain covering authentication, context, directives, Armor, operation filtering, trusted documents, errors, readiness, and logging.
  packages/graphql-server/src/createGraphQLYoga.ts#L63-90packages/graphql-server/src/createGraphQLYoga.ts#L103-159packages/graphql-server/src/createGraphQLYoga.ts#L161-212
• Database clients are application-owned: the todo fixture constructs PrismaClient in src/lib/db.js and its service performs queries and mutations against db.todo.
  __fixtures__/example-todo-main/api/src/lib/db.js#L1-6__fixtures__/example-todo-main/api/src/services/todos/todos.js#L1-21
• The server executable defaults NODE_ENV to production and provides combined, api-only, and web-only modes; the Lambda GraphQL wrapper instead translates API Gateway events into yoga.fetch requests.
  packages/api-server/src/bin.ts#L35-63packages/graphql-server/src/functions/graphql.ts#L71-106
• The router publishes ESM and CommonJS exports plus react-server conditionals for RSC routing; its dependencies pin a React 19 release candidate.
  packages/router/package.json#L10-20packages/router/package.json#L58-70packages/router/package.json#L96-103
• Documentation is a separate Docusaurus application with build, serve, start, and deploy scripts; its maintenance instructions identify docs/docs as the editable source.
  docs/package.json#L1-12docs/package.json#L26-37docs/README.md#L15-19