Skip to content

Portfolio

Personal projectWorking projectDistributed storage

GitStore

A personal cloud file system that stores encrypted files in the user's own private GitHub repositories, using an architecture inspired by HDFS.

The challenge

Personal cloud storage usually means paying for another service and trusting it with your files. GitStore explores using private repositories you already control as the storage layer.

The approach

Treat repositories as data nodes and an index repository as the name node, then deal with GitHub's limits through chunking, deduplication and several layers of caching.

What we did

Abrar designed and built the web application, the storage model, the Cloudflare Worker proxy and the mobile app. All 43 commits in the public repository are Abrar's.

The solution

Files are hashed, split, encrypted in the browser and uploaded in parallel. A search index and a five-layer cache keep retrieval quick, and the index is replicated for recovery.

Key features

  • SHA-256 deduplication before each upload
  • Client-side AES-256-GCM encryption
  • Chunked, parallel uploads for larger files
  • Five-layer cache from memory to the GitHub API
  • Inverted-index search and replicated index repositories
  • Web app and a React Native mobile app

Where it stands

The code is public, with its limits documented, including GitHub's API rate limits. We link only to the source here, because the hosted demo was not responding when this was checked.

Have a project in mind?

Tell us what you need. The first 30-minute call is free, and we'll talk it through with you and give an honest view of whether we are the right fit. We reply within 24 hours, usually sooner.

Not ready to talk yet? Build a project brief first