Reference
Supported File Types
Buildable and non-buildable file types, SCSS compilation, and bundle flags.
Buildable File Types
JavaScript and TypeScript
.js, .jsx, .mjs, .cjs, .ts, .tsx
These files are processed by esbuild during deployment. In bundled mode, they compile into a single IIFE. In per-file mode, they produce individual ES modules.
CSS
.css, .scss, .sass
CSS files are bundled into bundle.css. SCSS and SASS files are compiled via Dart Sass automatically during build.
Non-Buildable File Types
.txt, .md, .json, .html, .svg
These files are stored in the project but are not processed by esbuild. In per-file mode, they are uploaded as static assets and served from the CDN. In bundled and folder bundle modes, they are not included in build output.
Bundle Flags
| Flag | Scope | Effect |
|---|---|---|
include_in_bundle | File | Include in the main bundled output |
include_in_per_file | File | Include in per-file output |
is_bundle | Folder | Mark folder as a dedicated bundle |
exclude_from_bundle | Folder | Exclude folder contents from the main bundle |
Toggle these flags from the file tree context menu.
How File Type Affects Build Output
| File Type | Bundled Mode | Per-File Mode | Folder Bundle |
|---|---|---|---|
.js / .ts | Compiled into bundle.js | Individual ESM output | Compiled into folder bundle.js |
.css | Compiled into bundle.css | Individual CSS output | Compiled into folder bundle.css |
.scss / .sass | Compiled via Sass → bundle.css | Compiled via Sass → individual CSS | Compiled via Sass → folder bundle.css |
.json / .md / .html | Not included | Uploaded as static assets | Not included |