PushStack documentation
A GitHub-compatible code forge. User guide, REST API, internals and the libraries it is built on.
PushStack is a code forge that matches GitHub's behavior, names and API. These docs cover the hosted app at git.nandan.fyi, the code behind it, and the libraries and tools around it.
User guide
Create an account and a repository, clone it, push with a personal access token, work with issues and pull requests.
REST API
The GitHub-compatible API at /api/v3: auth, pagination and the endpoint compatibility matrix.
Architecture and internals
Request flow, git storage on R2, the database, security rules, performance, testing and deployment.
Libraries
git-fs-s3 and git-edge: git on S3-compatible storage, with no disk and no git binary.
CLI
The pushstack / pst command line: authenticate, manage repositories and call the REST API.