gitfor

<p align="center">
  <img src="public/favicon.png" alt="gitfor" width="96" height="96">
</p>

<h1 align="center">gitfor</h1>

<p align="center">
  Git hosting, code review and CI that runs entirely on Cloudflare.<br>
  Use it at <a href="https://gitfor.dev">gitfor.dev</a>, or deploy your own instance.
</p>

<p align="center">
  <a href="https://gitfor.dev">Website</a> ·
  <a href="docs/self-hosting.md">Self-host</a> ·
  <a href="docs/development.md">Develop</a> ·
  <a href="#documentation">Docs</a>
</p>

---

Repositories live in [Cloudflare Artifacts](https://developers.cloudflare.com/artifacts/). Everything else runs
on Workers, D1, KV, R2, Queues, Workflows, Durable Objects and Containers. There are no servers to manage.

## Features

- **Repositories**: create, import from any HTTPS remote, fork and archive, with public or private visibility.
  Browse trees, history, diffs, branches and tags, and edit files in the browser.
- **Pull requests**: cross-fork PRs, inline review threads, approvals, drafts, merge queues, and
  merge, squash or rebase.
- **Branch protection**: required reviews, status checks and code owner approval.
- **Issues**: labels, assignees, closing keywords (`fixes #12`) and full-text search.
- **Actions**: GitHub Actions–style workflows with matrices, `needs`, secrets, artifacts and live logs, on
  Cloudflare Containers or your own runners.
- **And more**: releases, webhooks, notifications, organizations, Sites hosting and an in-browser editor.

## Quick start

Clone over HTTPS with your username and a personal access token from **Settings → Access tokens**:

```sh
git clone https://gitfor.dev/alice/project.git
```

Add a workflow at `.gitfor/workflows/ci.yml`:

```yaml
on: [push, pull_request]
jobs:
  test:
    runs-on: cloudflare
    steps:
      - uses: actions/checkout@v4
      - run: bun install && bun test
```

## Run your own

```sh
bun install
bun run deploy
```

You need a Workers Paid account with Artifacts enabled. Resources, secrets and the first admin are covered
step by step in the [self-hosting guide](docs/self-hosting.md).

## Documentation

| Guide                                          | What it covers                                |
| ---------------------------------------------- | --------------------------------------------- |
| [Self-hosting](docs/self-hosting.md)           | Resources, configuration, deploying, scaling  |
| [Development](docs/development.md)             | Local setup, scripts, architecture            |
| [Workflows](docs/workflows.md)                 | Triggers, steps, third-party actions, runners |
| [Billing](docs/billing.md)                     | Optional Stripe plans and add-ons             |
| [Metering](docs/metering.md)                   | Usage limits and quotas                       |
| [Notifications](docs/notifications.md)         | Email and in-app notifications                |
| [Integrations](docs/integrations.md)           | Third-party integrations                      |
| [Analytics](docs/analytics.md)                 | Optional PostHog analytics                    |
| [Abuse handling](docs/abuse.md)                | Reports, takedowns, operator tools            |
| [Sites](docs/sites-design.md)                  | Static and dynamic site hosting               |
| [Editor](docs/editor-design.md)                | In-browser code editor                        |
| [Stacked pull requests](docs/stacked-pulls.md) | Working with dependent PRs                    |
| [Video](docs/video.md)                         | Encoding and serving marketing video          |

See the [roadmap](ROADMAP.md) for what's next.

## License

[0BSD](LICENSE)