How remix-run/remix works
Remix 3 is a composable web framework and package ecosystem. Its principal app workflow accepts a Fetch request in a server, routes it to controller actions, and returns a response; actions can render components or serve assets. Separate packages provide data access, authentication, sessions, middleware, and runtime tooling. The README documents these as standalone capabilities composed under the remix package. Some package-to-package wiring is not shown in the excerpts, so those relationships are omitted rather than inferred.
Main entry points: server.ts App server · index.ts Remix package · controller.tsx Controller actions · database.ts Relational queries
Components 29
Routing and UI
- Fetch router
packages/fetch-router/src/lib/router.ts - Route map
packages/fetch-router/src/lib/route-map.ts - Controller actions
template/app/actions/controller.tsx - Route patterns
packages/route-pattern/src/lib/match/program.ts - Component runtime
packages/component/src/runtime/render.ts - UI components
packages/ui/src/combobox.tsx
Identity and middleware
- Auth providers
packages/auth/src/lib/provider.ts - Auth middleware
packages/auth-middleware/src/lib/auth.ts - Session management
packages/session/src/lib/session.ts - Session middleware
packages/session-middleware/src/lib/session.ts - Request protections
packages/csrf-middleware/src/lib/csrf.ts
Data and storage
- Schema validation
packages/data-schema/src/lib/schema.ts - Relational queries
packages/data-table/src/lib/database.ts - SQL drivers
packages/data-table/src/lib/driver.ts - MySQL adapter
packages/data-table-mysql/src/lib/driver.ts - Postgres adapter
packages/data-table-postgres/src/lib/driver.ts - SQLite adapter
packages/data-table-sqlite/src/lib/driver.ts - File storage
packages/file-storage/src/lib/file-storage.ts - S3 storage
packages/file-storage-s3/src/lib/s3.ts
Runtime and development
- App server
template/server.ts - Fetch server
packages/node-fetch-server/src/lib/fetch-handler.ts - Component HMR
packages/component-hmr/src/lib/transform.ts
CLI tooling
- Remix CLI
packages/cli/src/lib/cli.ts - Routes command
packages/cli/src/lib/commands/routes.ts - Route inspection
packages/cli/src/lib/route-map.ts
Remix distribution
- Remix package
packages/remix/src/index.ts
Other components
- App developer
- HTTP client
- Node server
Connections 26
- App developer → Remix CLI: runs commands
- HTTP client → App server: sends request
- Node server → App server: runs
template/server.ts - App server → Fetch router: dispatches to
template/server.ts - App server → Fetch server: uses
- Fetch router → Controller actions: routes to
- Controller actions → Route map: uses routes
template/app/actions/controller.tsx - Controller actions → Component runtime: renders
template/app/actions/controller.tsx - Controller actions → UI components: renders page
template/app/actions/controller.tsx - Fetch router → Route patterns: matches paths
- App server → Controller actions: serves actions
- App server → Component HMR: supports refresh
- Remix CLI → Routes command: dispatches command
- Routes command → Route inspection: loads route map
packages/cli/src/lib/commands/routes.ts - Relational queries → SQL drivers: executes operations
packages/data-table/src/lib/database.ts - MySQL adapter → Relational queries: adapts toolkit
- Postgres adapter → Relational queries: adapts toolkit
- SQLite adapter → Relational queries: adapts toolkit
- S3 storage → File storage: implements backend
- Session middleware → Session management: manages sessions
- Auth middleware → Auth providers: authenticates with
- Remix package → Fetch router: distributes
README.md - Remix package → Component runtime: distributes
README.md - Remix package → Relational queries: distributes
README.md - Remix package → Auth providers: distributes
README.md - Remix package → Remix CLI: distributes
README.md