Heroku Cloud Native Buildpacks: Front-end Web

🚧 This repo is experimental. Use at your own risk. 🚧

This repository is the home of Heroku Cloud Native Buildpacks for Front-end Web apps, also known as: static websites, static web apps (SWA), single-page apps (SPA), and browser apps.

Included Buildpacks

This repository contains multiple buildpacks:

Component Buildpacks

Buildpacks that provide a specific server-side component.

ID	Name	Provides
heroku/static-web-server	Static Web Server	Web Server supporting build and runtime configuration, as well as configuration inheritance from other buildpacks

Framework Buildpacks

Lower-level buildpacks that detect specific source layouts, frameworks, or tools, to automate configuration of build process and heroku/static-web-server.

ID	Name	Provides
heroku/website-ember	Website (Ember.js)	auto-detect for ember-cli
heroku/website-nextjs	Website (Next.js)	auto-detect for Next.js
heroku/website-public-html	Website (Public HTML)	auto-detect for public/index.html
heroku/website-vite	Website (Vite)	auto-detect for vite

Usage

See the individual buildpack documentation, linked in the above table.

Dev Notes

Run Tests

cargo test -- --include-ignored

Updating Node.js

These buildpacks include the heroku/nodejs buildpack, packaged at a specific version. To update the Node.js buildpack:

1. check the Docker Hub listing for the latest version
2. update the version specified in the website-nodejs buildpack & package specifications
3. ensure integration tests still pass, see Run Tests

Releasing A New Version

Action workflows are used to automate the release process:

1. Run Prepare Buildpack Releases.
2. Await completion of the preparation step.
3. Run Release Buildpacks.