mirror of https://github.com/fabro-sh/fabro.git synced 2026-08-28 05:27:41 +00:00

docs: offer issue-based contribution path alongside PRs

Add a third option for contributors who'd rather not write the code
themselves: file an issue and a maintainer will implement it with
co-author credit on the landing commit.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

2026-05-16 13:40:23 -04:00

1.9 KiB

Raw Blame History

Contributing to Fabro

Thanks for your interest in contributing to Fabro!

How to contribute

Outside contributions are welcome! Whether it's a bug fix, a new feature, documentation, or a typo -- we'd love your help making Fabro better.

Bug fixes and small improvements -- Send a pull request directly. No need to open an issue first.
Larger features or changes -- Please open a GitHub Issue or start a Discussion first so we can align on the approach before you invest significant time.
Prefer not to write the code yourself? -- As an alternative to opening a PR, you can file a GitHub Issue describing the bug or feature. A Fabro maintainer will implement it (supervising AI coding agents and workflows) and include you as a co-author on the commit that lands the change.
Questions -- Open a Discussion or email bryan@qlty.sh.

Development setup

The instructions below will help you build and test Fabro locally.

Prerequisites

Rust (latest stable)
Bun (for the web frontend)
Git

Build and test

# Build all Rust crates
cargo build --workspace

# Run all tests
cargo test --workspace

# Check formatting and lint
cargo fmt --check --all
cargo clippy --workspace -- -D warnings

Web frontend (fabro-web)

cd apps/fabro-web
bun install
bun run dev        # start dev server
bun test           # run tests
bun run typecheck  # type check

Development workflow

Create a branch from main
Make your changes
Ensure cargo test --workspace, cargo fmt --check --all, and cargo clippy --workspace -- -D warnings pass

License

By contributing, you agree that your contributions will be licensed under the MIT License.

1.9 KiB Raw Blame History