Skip to main content
Prerequisites:
  • Node.js version 22 or higher
  • pnpm version 10.19.0 or higher
  • A Cloudflare account (free tier works)
Gitflare is a self-hosted Git hosting platform built to run on Cloudflare’s serverless infrastructure. Follow these steps to set up your local development environment.
1

Install Node.js

Ensure you have Node.js v22 or higher installed on your system. You can verify your Node.js version by running:
node --version
If you need to install or upgrade Node.js, download it from nodejs.org or use a version manager like nvm.
2

Install pnpm

Gitflare uses pnpm for package management and workspace support. Install pnpm globally:
npm install -g [email protected]
Verify the installation:
pnpm --version
3

Clone the repository

Clone the Gitflare repository to your local machine:
git clone https://github.com/yourusername/gitflare.git
cd gitflare
4

Install dependencies

Install all project dependencies using pnpm:
pnpm install
This command installs dependencies for all workspaces in the monorepo, including the web application and any packages.
The project uses pnpm workspaces with Turborepo for efficient monorepo management.
5

Set up Cloudflare account

You need a Cloudflare account to deploy Gitflare. If you don’t have one:
  1. Visit cloudflare.com and sign up for a free account
  2. Note your Account ID from the Cloudflare dashboard
  3. You’ll need this for deployment and database setup

​
Verify installation

To verify everything is set up correctly, run the type checker: 
pnpm typecheck
If the command completes without errors, your installation is successful.

​
Project structure

Gitflare is organized as a monorepo: 
gitflare/
├── apps/
│   └── web/              # TanStack Start application
│       ├── src/          # Application source code
│       ├── migrations/   # Database migrations
│       └── alchemy.run.ts # Alchemy deployment configuration
├── packages/             # Shared packages (if any)
└── package.json          # Root workspace configuration

​
Next steps

Configuration

Configure environment variables and Cloudflare services

Deployment

Deploy Gitflare to Cloudflare Workers

Build docs developers (and LLMs) love

Get started for freeTalk to us