> ## Documentation Index
> Fetch the complete documentation index at: https://paper.brimble.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Frameworks supported

> Brimble's build pipeline auto-detects most popular frameworks and pre-fills the install, build, and start commands.

Brimble's build pipeline auto-detects most popular frameworks and pre-fills the install, build, and start commands. This page lists what's detected and what defaults you get.

If your stack isn't listed, set the commands manually under **Configuration**. Anything that runs in a Linux container will work, detection is a convenience, not a requirement.

## How detection works

Brimble inspects:

* The repo root for known files (`package.json`, `requirements.txt`, `Gemfile`, `go.mod`, `Cargo.toml`, `composer.json`, `pom.xml`, `build.gradle`, `mix.exs`, `Dockerfile`).
* The contents of those files for framework-specific signals (e.g. `next` in `dependencies`).
* A few file-pattern checks (`Procfile`, `wrangler.toml`, etc.).

A `Dockerfile` at the repo root takes precedence, Brimble uses it directly and skips framework detection.

## <img src="https://cdn.simpleicons.org/nodedotjs" alt="" width="20" height="20" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> Node.js

Detected via `package.json`.

| Framework                                                                                                                                                                             | Service type               | Default commands                                                                                                                               |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| <img src="https://cdn.simpleicons.org/nextdotjs" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Next.js (server)**      | Web service                | `npm install`, `npm run build`, `npm start`                                                                                                    |
| <img src="https://cdn.simpleicons.org/nextdotjs" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Next.js (export)**      | Static site                | `npm install`, `npm run build`, output `out/` (requires `output: "export"` in `next.config.js`)                                                |
| <img src="https://cdn.simpleicons.org/nuxt" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Nuxt 3 (server)**            | Web service                | `npm install`, `npm run build`, `node .output/server/index.mjs`                                                                                |
| <img src="https://cdn.simpleicons.org/nuxt" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Nuxt 3 (static)**            | Static site                | `npm install`, `npx nuxi generate`, output `.output/public/` (requires `nitro.preset: "static"` or running `nuxi generate` instead of `build`) |
| <img src="https://cdn.simpleicons.org/svelte" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **SvelteKit**                | Web service                | `npm install`, `npm run build`, `node build`                                                                                                   |
| <img src="https://cdn.simpleicons.org/remix" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Remix**                     | Web service                | `npm install`, `npm run build`, `npm start`                                                                                                    |
| <img src="https://cdn.simpleicons.org/vite" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Vite**                       | Static site                | `npm install`, `npm run build`, output `dist/`                                                                                                 |
| <img src="https://cdn.simpleicons.org/astro" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Astro**                     | Static site or Web service | `npm install`, `npm run build`, output `dist/`                                                                                                 |
| <img src="https://cdn.simpleicons.org/express" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Express / Fastify / Koa** | Web service                | `npm install`, no build, `npm start`                                                                                                           |
| <img src="https://cdn.simpleicons.org/nestjs" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **NestJS**                   | Web service                | `npm install`, `npm run build`, `npm run start:prod`                                                                                           |
| <img src="https://cdn.simpleicons.org/hono" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Hono**                       | Web service                | `npm install`, `npm run build`, `npm start`                                                                                                    |
| <img src="https://cdn.simpleicons.org/adonisjs" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **AdonisJS**               | Web service                | `npm install`, `npm run build`, `node build/server.js`                                                                                         |

Package manager auto-detected from lockfile: `package-lock.json` → <img src="https://cdn.simpleicons.org/npm" alt="" width="12" height="12" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> npm, `yarn.lock` → <img src="https://cdn.simpleicons.org/yarn" alt="" width="12" height="12" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> yarn, `pnpm-lock.yaml` → <img src="https://cdn.simpleicons.org/pnpm" alt="" width="12" height="12" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> pnpm, `bun.lockb` → <img src="https://cdn.simpleicons.org/bun" alt="" width="12" height="12" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> bun.

Node version auto-detected from `engines.node` in `package.json` or a `.nvmrc` file. Latest LTS by default.

## <img src="https://cdn.simpleicons.org/python" alt="" width="20" height="20" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> Python

Detected via `requirements.txt`, `pyproject.toml`, or `Pipfile`.

| Framework                                                                                                                                                             | Service type | Default commands                                                                  |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | --------------------------------------------------------------------------------- |
| <img src="https://cdn.simpleicons.org/django" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Django**   | Web service  | `pip install -r requirements.txt`, `gunicorn <project>.wsgi`                      |
| <img src="https://cdn.simpleicons.org/flask" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Flask**     | Web service  | `pip install -r requirements.txt`, `gunicorn app:app`                             |
| <img src="https://cdn.simpleicons.org/fastapi" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **FastAPI** | Web service  | `pip install -r requirements.txt`, `uvicorn main:app --host 0.0.0.0 --port $PORT` |

Python version detected from `.python-version`, `runtime.txt`, or `pyproject.toml`. Defaults to a recent stable version.

Package manager: <img src="https://cdn.simpleicons.org/pypi" alt="" width="12" height="12" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> pip (`requirements.txt`), <img src="https://cdn.simpleicons.org/poetry" alt="" width="12" height="12" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> Poetry (`pyproject.toml` with `[tool.poetry]`), or pipenv (`Pipfile`).

## <img src="https://cdn.simpleicons.org/ruby" alt="" width="20" height="20" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> Ruby

Detected via `Gemfile`.

| Framework                                                                                                                                                               | Service type | Default commands                                                                                        |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------- |
| <img src="https://cdn.simpleicons.org/rubyonrails" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Rails** | Web service  | `bundle install`, `bundle exec rails assets:precompile`, `bundle exec rails server -p $PORT -b 0.0.0.0` |
| <img src="https://cdn.simpleicons.org/ruby" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Sinatra**      | Web service  | `bundle install`, no build, `bundle exec ruby app.rb -o 0.0.0.0 -p $PORT`                               |

Ruby version from `.ruby-version` or `Gemfile`.

## <img src="https://cdn.simpleicons.org/go" alt="" width="20" height="20" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> Go

Detected via `go.mod`.

* Service type: Web service.
* Build: `go build -o app .`
* Start: `./app`

Go version from `go.mod`.

## <img src="https://cdn.simpleicons.org/php" alt="" width="20" height="20" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> PHP

Detected via `composer.json`.

| Framework                                                                                                                                                             | Service type | Default commands                                                                                            |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ----------------------------------------------------------------------------------------------------------- |
| <img src="https://cdn.simpleicons.org/laravel" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Laravel** | Web service  | `composer install --no-dev`, `php artisan migrate --force`, `php artisan serve --host=0.0.0.0 --port=$PORT` |
| <img src="https://cdn.simpleicons.org/symfony" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Symfony** | Web service  | `composer install --no-dev`, `bin/console cache:clear`, `php -S 0.0.0.0:$PORT public/index.php`             |

## <img src="https://cdn.simpleicons.org/openjdk" alt="" width="20" height="20" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> Java / Kotlin

Detected via `pom.xml` (Maven) or `build.gradle` / `build.gradle.kts` (Gradle).

| Framework                                                                                                                                                                    | Service type | Default commands                                                              |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ----------------------------------------------------------------------------- |
| <img src="https://cdn.simpleicons.org/springboot" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Spring Boot** | Web service  | `./mvnw package -DskipTests` (or Gradle equivalent), `java -jar target/*.jar` |

JVM version from `pom.xml`'s `<java.version>` or Gradle's `targetCompatibility`.

## <img src="https://cdn.simpleicons.org/rust" alt="" width="20" height="20" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> Rust

Detected via `Cargo.toml`.

* Service type: Web service.
* Build: `cargo build --release`
* Start: `./target/release/<bin-name>`

Rust toolchain from `rust-toolchain.toml` or stable.

## <img src="https://cdn.simpleicons.org/elixir" alt="" width="20" height="20" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> Elixir

Detected via `mix.exs`.

* Service type: Web service.
* Build: `mix deps.get`, `mix compile`, asset compilation if <img src="https://cdn.simpleicons.org/phoenixframework" alt="" width="12" height="12" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> Phoenix.
* Start: `mix phx.server` or `MIX_ENV=prod elixir --erl '-detached' -S mix run --no-halt`.

## Static-only frameworks

| Framework                                                                                                                                                                      | Default commands                                              |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------- |
| <img src="https://cdn.simpleicons.org/hugo" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Hugo**                | `hugo`, output `public/`                                      |
| <img src="https://cdn.simpleicons.org/jekyll" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Jekyll**            | `bundle install`, `bundle exec jekyll build`, output `_site/` |
| <img src="https://cdn.simpleicons.org/eleventy" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Eleventy (11ty)** | `npm install`, `npx eleventy`, output `_site/`                |
| <img src="https://cdn.simpleicons.org/gatsby" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Gatsby**            | `npm install`, `npm run build`, output `public/`              |
| <img src="https://cdn.simpleicons.org/docusaurus" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **Docusaurus**    | `npm install`, `npm run build`, output `build/`               |
| <img src="https://cdn.simpleicons.org/markdown" alt="" width="14" height="14" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> **MkDocs**          | `pip install mkdocs`, `mkdocs build`, output `site/`          |

For all of the above, Brimble creates a static site project (no runtime container).

## <img src="https://cdn.simpleicons.org/docker" alt="" width="20" height="20" style={{display:"inline-block",verticalAlign:"middle",marginRight:"6px"}} /> Dockerfile

If a `Dockerfile` exists at the project root, Brimble uses it directly:

* Build: `docker build -t <image> .`
* Start: `docker run -e PORT=$PORT -p $PORT <image>`

The Dockerfile must:

* Use `EXPOSE` for the listener port (or the container must listen on `$PORT` regardless).
* Run as a non-root user where possible.
* End with a `CMD` that launches your service in the foreground.

## Custom commands

For any framework, detected or not, you can override under **Configuration**:

* **Install command**, typically the package manager install step.
* **Build command**, anything that compiles or bundles. Empty for runtime-only languages.
* **Pre-start command**, runs once per build, after the build, before the artifact is pushed. Useful for migrations.
* **Start command**, launches the runtime container. Must keep the process in the foreground.

The commands run in `bash`. Standard shell features (pipes, redirects, `&&`) work.

## Language version selection

Most frameworks default to a recent stable version. Pin a specific version via the language's standard mechanism:

* <span style={{display:"inline-flex",alignItems:"center",gap:"6px"}}><img src="https://cdn.simpleicons.org/nodedotjs" alt="" width="14" height="14" /><b>Node:</b></span> `engines.node` in `package.json`, or `.nvmrc`.
* <span style={{display:"inline-flex",alignItems:"center",gap:"6px"}}><img src="https://cdn.simpleicons.org/python" alt="" width="14" height="14" /><b>Python:</b></span> `.python-version`, `runtime.txt`, or `pyproject.toml`.
* <span style={{display:"inline-flex",alignItems:"center",gap:"6px"}}><img src="https://cdn.simpleicons.org/ruby" alt="" width="14" height="14" /><b>Ruby:</b></span> `.ruby-version` or `Gemfile`.
* <span style={{display:"inline-flex",alignItems:"center",gap:"6px"}}><img src="https://cdn.simpleicons.org/go" alt="" width="14" height="14" /><b>Go:</b></span> `go.mod`'s `go` directive.
* <span style={{display:"inline-flex",alignItems:"center",gap:"6px"}}><img src="https://cdn.simpleicons.org/openjdk" alt="" width="14" height="14" /><b>Java:</b></span> `pom.xml` `<java.version>` or Gradle `targetCompatibility`.

If detection picks the wrong version, the deployment logs will show the chosen version under the **Detect** phase. Pin explicitly to fix.