Blossom Logo Blossom

Build Types

Categories: build configuration deployment
2 min read

Blossom supports multiple build types to accommodate different application architectures and deployment needs.

Build Types

Auto

Default build type - Blossom automatically detects the best build method for your application based on project files.

  • Detects Dockerfile, buildpacks, or static site generators
  • Automatically selects appropriate build type
  • Best for most applications

Dockerfile

Builds using a Dockerfile in your repository.

  • Full control over the build process
  • Use docker buildx build commands
  • Requires Dockerfile in project root
  • Best for custom build requirements

Buildpack

Builds using Cloud Native Buildpacks.

  • Automatic dependency detection
  • Requires builder selection (e.g., heroku/builder:24)
  • Handles runtime detection and dependency installation
  • Best for applications following standard conventions

Nixpacks

Builds using Nixpacks auto-detection.

  • Automatically detects languages and frameworks
  • Generates optimized Docker images
  • No configuration needed
  • Best for modern applications with standard setups

Railpack

Rails-specific buildpack optimized for Ruby on Rails applications.

  • Specialized for Rails applications
  • Optimized build process for Ruby/Rails
  • Handles Rails-specific dependencies
  • Best for Ruby on Rails projects

Static

Builds static sites with automatic static site generator detection.

  • Detects and builds static site generators (Next.js, Jekyll, Hugo, etc.)
  • Creates optimized nginx-based images
  • Handles JavaScript asset building
  • Best for static websites and SPAs

See Static Site Generators for details.

Prebuilt

Uses a pre-built container image from your container registry.

  • No build step required
  • Requires image name from registry
  • Skips git repository requirements
  • Best for images already built elsewhere

Configuration

Each build type has specific requirements:

  • Buildpack: Requires builder selection
  • Prebuilt: Requires image name
  • Dockerfile/Static: Requires Dockerfile in project
  • Auto: Automatically configured
Build Customizations Static Site Generators
Blossom Docs