Skip to content
ForkPress

Development

Local development needs a Rust toolchain, Make, PHP, PHP development headers, and SQLite development libraries.

Build

Build the production runtime bundle and binary:

Terminal window
make dist
make forkpress

make dist builds the production static PHP runtime. make forkpress embeds that runtime and the PHP/WordPress assets into the production Rust binary.

Test

Run Rust tests:

Terminal window
cargo test --workspace --exclude forkpress-cli
FORKPRESS_RUNTIME_BUNDLE=/dev/null cargo test -p forkpress-cli

Run PHP tests:

Terminal window
make test-all

Documentation site

The documentation site is an Astro Starlight project at the repository root.

Terminal window
npm install
npm run dev
npm run validate

npm run validate runs Astro checks, documentation tests, and the static site build.

Releases

Release automation is documented in Releases. In short:

  • Release: prepare updates release metadata and opens a release PR.
  • Release: verify builds and smoke-tests release artifacts before merge.
  • Release: publish rebuilds from the merge commit, creates the GitHub release, and updates Homebrew for stable releases.