diff options
Diffstat (limited to '')
| -rw-r--r-- | docs/rfcs/README.md | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/docs/rfcs/README.md b/docs/rfcs/README.md index 284ceaf3a..42360635c 100644 --- a/docs/rfcs/README.md +++ b/docs/rfcs/README.md @@ -16,3 +16,13 @@ The spec for bundler configuration object is defined in [`bun-build-config.ts`][ A class for orchestrating builds & HTTP. This class is a layer that sits on top of the `Bun.build` and `Bun.serve`, intended primarily for use by framework authors. - `class` [`Bun.App`][./bun-app.ts]: other possible names: `Bun.Builder`, `Bun.Engine`, `Bun.Framework` + +High-level: an `App` consists of a set of _bundlers_ and _routers_. During build/serve, Bun will: + +- iterate over all routers +- each router specifies a bundler configuration (the `build` key) and an `entrypoint`/`dir` + - if dir, all files in entrypoint are considered entrypoints +- everything is bundled +- the built results are served over HTTP + - each router has a route `prefix` from which its build assets are served + - for "mode: handler", the handler is loaded and called instead of served as a static asset |