v3 → v4 Docs Map
If you had a v3 documentation URL bookmarked, here is exactly where it moved.
This documentation site has been reorganized twice since v3: once to rename top-level folders
(getting-started → start, api-reference → reference, examples → guides), and again
to flatten and rename reference/, internals/, and resources/. The table below maps every
old URL to its current location — use it to update bookmarks or inbound links.
This page is about the docs site, not the framework API
For actual v3 → v4 breaking changes to packages, imports, and runtime behavior, see Breaking Changes instead.
Top-level folder renames
| Old URL | New URL |
|---|---|
/docs/getting-started | /docs/start |
/docs/api-reference | /docs/reference |
/docs/examples | /docs/guides |
/docs/internals | /docs/architecture |
/docs/resources | /docs/help |
Reference — flattened from three levels to one
reference/core/*, reference/middleware/*, and reference/plugins/* all collapsed directly
into reference/*; reference/adapters/* was renamed to reference/platforms/*.
| Old URL | New URL |
|---|---|
/docs/reference/core/router | /docs/reference/router |
/docs/reference/core/types | /docs/reference/types |
/docs/reference/core/errors | /docs/reference/errors |
/docs/reference/core/runtime | /docs/reference/runtime |
/docs/reference/middleware/cors | /docs/reference/cors |
/docs/reference/middleware/validation | /docs/reference/validation |
/docs/reference/plugins/events | /docs/reference/events |
/docs/reference/plugins/websocket | /docs/reference/websocket |
/docs/reference/adapters/node | /docs/reference/platforms/node |
/docs/reference/adapters/bun | /docs/reference/platforms/bun |
/docs/reference/adapters/deno | /docs/reference/platforms/deno |
/docs/reference/adapters/edge | /docs/reference/platforms/edge |
/docs/reference/di | /docs/reference/class |
/docs/reference/di/decorators | /docs/reference/class/decorators |
The mapping above covers every old reference/* path from both the original
api-reference/* era and the post-T6, pre-B3 reference/* era.
Internals → Architecture
| Old URL | New URL |
|---|---|
/docs/internals | /docs/architecture |
/docs/internals/design-principles | /docs/architecture/design-principles |
/docs/internals/package-hierarchy | /docs/architecture/package-hierarchy |
/docs/internals/router-internals | /docs/architecture/router-internals |
/docs/internals/di-internals | /docs/architecture/di-internals |
/docs/internals/adapters | /docs/architecture/adapters |
/docs/internals/rfcs | /docs/architecture/rfcs |
/docs/internals/versioning | /docs/architecture/versioning |
/docs/internals/contributing | /docs/community/contributing (merged, not renamed alone) |
Resources → Help / Community
resources/ retired: four reference pages became a new top-level help/ folder, two
project-status pages moved into community/, and package-catalog.mdx was retired entirely as
a duplicate of the newer Packages A-Z reference page.
| Old URL | New URL |
|---|---|
/docs/resources | /docs/help |
/docs/resources/faq | /docs/help/faq |
/docs/resources/troubleshooting | /docs/help/troubleshooting |
/docs/resources/glossary | /docs/help/glossary |
/docs/resources/compatibility-matrix | /docs/help/compatibility-matrix |
/docs/resources/roadmap | /docs/community/roadmap |
/docs/resources/changelog | /docs/community/changelog |
/docs/resources/package-catalog | /docs/reference/packages (retired, not moved — see below) |
Package Catalog was retired, not renamed
resources/package-catalog.mdx's content — a per-package install-command list — duplicated
the newer Packages A-Z reference page almost exactly. Rather than
carry two overlapping pages forward, the old page was deleted and its URL now redirects
straight to the replacement.
Examples → Guides
| Old URL | New URL |
|---|---|
/docs/examples/hello-world | /docs/getting-started/quick-start |
/docs/examples/rest-api | /docs/guides/api-development/rest-api |
/docs/examples/class-based-api | /docs/guides/api-development/class-based |
/docs/examples/authentication | /docs/guides/authentication/authentication |
/docs/examples/database | /docs/guides/data/database |
/docs/examples/websocket | /docs/guides/communication/websocket |
/docs/examples/file-upload | /docs/guides/data/file-upload |
Verifying a specific URL yourself
The tables above are a complete mapping of every v3 URL to its v4 location. Every entry is single-hop — the old URL points directly at the final page, whether it moved once or twice.
Next steps
- Breaking Changes — actual framework API changes, not docs URLs.
- Upgrade guide — what a version bump means today.