charles/project-boilerplates
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
22 commits 1 branch 0 tags 120 KiB
  • Just 29.8%
  • Rust 25.3%
  • TypeScript 12.4%
  • Python 12.1%
  • Dockerfile 10.2%
  • Other 10.1%
Find a file
Exact
Claude Desktop 3c536b1c34 fix(ci): remove redundant GITHUB_PATH — cargo symlinked in ci-base image
2026-04-13 19:34:00 +00:00
_shared feat: initial project boilerplates for 5 tech stacks 2026-04-07 00:26:20 +02:00
bun-typescript-web refactor(ci): remove redundant deps from ci-setup (provided by ci-base image) 2026-04-13 18:26:41 +00:00
ci-base fix(ci-base): symlink cargo tools to /usr/local/bin for runner compatibility 2026-04-13 18:25:45 +00:00
ci-base-infra feat: add Alpine-based CI infra image for IaC repos 2026-04-13 19:02:50 +00:00
php-web refactor(ci): remove redundant deps from ci-setup (provided by ci-base image) 2026-04-13 18:27:29 +00:00
python-web refactor(ci): remove redundant deps from ci-setup (provided by ci-base image) 2026-04-13 18:28:04 +00:00
rust-desktop fix(ci): remove redundant GITHUB_PATH — cargo symlinked in ci-base image 2026-04-13 19:33:42 +00:00
rust-web fix(ci): remove redundant GITHUB_PATH — cargo symlinked in ci-base image 2026-04-13 19:34:00 +00:00
CLAUDE.md feat: initial project boilerplates for 5 tech stacks 2026-04-07 00:26:20 +02:00
README.md feat: initial project boilerplates for 5 tech stacks 2026-04-07 00:26:20 +02:00

README.md

Project Boilerplates

Ready-to-use project templates for the PO bot. Each boilerplate includes:

  • Justfile with standardized targets (dev, test, coverage, lint, fmt, qa, setup)
  • Tests with 80% coverage threshold
  • CI via Forgejo workflows (QA + deploy trigger)
  • IAC folder for Proxmox deployment (Terraform + Ansible)
  • Monorepo structure where applicable (core + ui/web)
  • Linting/formatting for all file types
  • CLAUDE.md for AI agents, README.md for humans

Boilerplates

Stack Directory Structure Key Tools
Rust Desktop rust-desktop/ Cargo workspace: core + GTK4 clippy, tarpaulin, tombi, rumdl
Rust Web rust-web/ Cargo workspace: core + Axum clippy, tarpaulin, tombi, rumdl
Bun TypeScript bun-typescript-web/ Bun workspace: core + Hono biome, bun:test, rumdl
PHP Web php-web/ Laravel 13 pint, phpunit, rumdl
Python Web python-web/ uv workspace: core + FastAPI ruff, pytest, rumdl

Shared Files

_shared/ contains files common to all projects:

  • .editorconfig — editor formatting rules
  • .rumdl.toml — markdown linting config
  • iac/ — Terraform + Ansible templates for Proxmox LXC deployment
  • .forgejo/workflows/ — deploy and destroy workflow templates

Usage (PO Bot)

  1. Choose the boilerplate matching the tech stack
  2. Create a new Forgejo repo
  3. Copy boilerplate files, renaming myapp to the project name
  4. Copy _shared/iac/ into the project's iac/ folder
  5. Copy _shared/.forgejo/workflows/deploy.yml and destroy.yml
  6. Customize terraform variables (container ID, IP, domain)
  7. Commit, push, and configure CI secrets

Justfile Targets (All Projects)

Target Description
just dev Start dev server with hot reload
just test Run test suite
just coverage Run tests with 80% coverage threshold
just lint Run all linters
just fmt Format all files
just qa Format + lint + test (full check)
just setup First-time project setup
just install-deps Install system dependencies