Contributing

Build the builder with us.

Pressroot is MIT-licensed and grows by contribution β€” and you don't have to write PHP to make it meaningfully better.

Ways to contribute

Pick your lane.

πŸͺ

Site types

Know an industry we don't cover? A site type is starter pages + marketing questions + design pools. The restaurant/realty/affiliate types are the templates to copy.

🎨

Style kits & trends

Kits are palette + fonts + radii; trends are CSS-only layers (glassmorphism, neo-brutalist, editorial serif…). Both are small, self-contained, and very PR-able.

πŸ“–

Build recipes

Write a copy-paste walkthrough for your industry like the restaurant recipe β€” the best marketing docs the project can have.

🧩

Core code

The generator, AI connectors, smart blocks, and settings UI. PHP 8.3, Sage 11, Blade, Tailwind v4. Start with issues labeled good first issue.

🌍

Translations

Every string is gettext-ready under the pressroot text domain. A .po file for your language makes the whole generator usable in it.

πŸ›

Triage & docs

Reproduce bugs, improve these docs, or answer questions in issues. Unsexy, hugely valuable.

Dev setup

Running in five minutes.

git clone https://github.com/YOUR-FORK/pressroot
cd pressroot
composer install && npm install
npm run wp        # WordPress Playground β†’ http://127.0.0.1:8881 (admin / password)
npm run dev       # Vite HMR while you work
1

Branch

feat/<short-name> or fix/<short-name> off main. One concern per PR.

2

Check

composer lint (Pint) and npm run build must pass. PHP is namespaced under App\; new files register in functions.php's collect list.

3

PR

Describe what + why, screenshots for anything visual, and note which site types you tested against. Small PRs merge fast.

House rules: the AI never writes block markup (text and images only), generated pages use core blocks + coded theme blocks (no Custom HTML), keys never reach the browser, and free-by-default is non-negotiable. See Code of Conduct.
Roadmap

Where this is going.

🎬 AI video hero β€” Luma / Runway generation (next milestone) πŸ›’ WooCommerce site type πŸ“– More build recipes β€” realty, affiliate, agency 🌍 Multilingual generation 🧱 More smart blocks β€” testimonials, pricing, FAQ

Say hi before you build big.

For anything larger than a bugfix, open an issue first so we can agree on the approach β€” it keeps your PR mergeable.