Serverless · Zero-Cost · Open Source

Ace
Clouds.

Your files. Anywhere. No server needed.

Serverless cloud file storage powered by Cloudflare Workers and GitHub as a backend. Upload, download, browse, and delete — from any device, forever free.

Cloudflare Workers
GitHub Storage
PWA Ready
0
Servers to manage
File Storage
0+
Global PoPs
$0
Monthly cost
Scroll
Architecture

Four layers.
One clean system.

Ace Clouds chains together four battle-tested platforms — each doing exactly what it's best at. The result is a file manager that's faster, cheaper, and more secure than any VPS-based alternative.

Explore the Repo
🌐
Browser / PWA
Hosted on Cloudflare Pages — installable on any device
fetch("/api?...")
Cloudflare Pages Function
Proxy layer — hides Worker URL, handles CORS
forwards + hides Worker
🔥
Cloudflare Worker
Edge inference — token never exposed to client
GitHub REST API v3
🗄
GitHub Repository
Your file storage — private or public, free forever
Layer 01
Cloudflare Pages
Hosts the frontend PWA globally. Your UI is always fast, always online — with zero cold starts on the client side.
Layer 02
Cloudflare Workers
Handles all API logic at the edge. Your GitHub token stays encrypted in Worker environment variables — never in the browser.
Layer 03
GitHub Storage
Acts as the persistent file backend via REST API v3. Private repos ensure only you can access your data.
Capabilities

Everything you need.
Nothing you don't.

A file manager that works anywhere, costs nothing, and never asks you to maintain infrastructure. Built for developers and power users alike.

Upload & Overwrite

Send any text-based file directly to your GitHub repo via a clean drag-and-drop or file picker. Overwrite existing files seamlessly.

Download Anytime

Fetch any stored file by name and save it locally with a single click. Works from any browser, any device, anywhere on Earth.

Browse & Search

List every file in your repo with size, SHA, and quick actions. Real-time search filters your file list instantly as you type.

Delete Files

Permanently remove files from GitHub directly from the UI. Clean SHA-based deletion ensures no orphaned data is left behind.

PWA Installable

Install Ace Clouds on Android, iOS, and desktop as a full Progressive Web App. Service Worker caches the app shell for offline viewing.

Token Never Exposed

Your GitHub Personal Access Token lives only in Cloudflare Worker environment variables — encrypted, server-side, invisible to the browser.

Documentation

Deploy in minutes.

No build step, no dependencies, no servers. Everything you need to get Ace Clouds running — for free — in under 10 minutes.

Getting Started
Quick Start
Prerequisites
Deployment
GitHub Repo
Cloudflare Worker
Pages Deploy
Reference
API Reference
Env Variables
Quick Start

Deploy in 5 steps

Ace Clouds requires no build step — just plain HTML and JavaScript. Get from zero to a working file manager in minutes using only free-tier Cloudflare and GitHub accounts.

1
Fork the repo — Head to github.com/VikasPatel22/ace-clouds-resources and fork or clone it.
2
Create a storage repo — Make a new (private) GitHub repo (e.g. ace-clouds-st) initialized with a README.
3
Generate a PAT — Go to GitHub Settings → Developer settings → Tokens (classic) → generate token with repo scope.
4
Deploy the Worker — Create a Cloudflare Worker, paste worker.js, add the four env variables.
5
Deploy to Pages — Connect your fork to Cloudflare Pages, add WORKER_URL env var, redeploy. Done.
Prerequisites

What you need

All free. No credit card required for any of these.

RequirementDetailsCost
Cloudflare accountWorkers & Pages (free tier)$0
GitHub accountOne dedicated storage repo (can be private)$0
GitHub PATClassic token with repo scope$0
GitHub

Create your storage repository

Your GitHub repo acts as the storage backend. Create a dedicated repo — private is recommended so files aren't publicly accessible via raw GitHub URLs.

1
Go to github.com/new and create a new repo (e.g. ace-clouds-st)
2
Set visibility to Private and initialize with a README so the main branch exists
3
Go to Settings → Developer settings → Personal access tokens → Generate new token (classic) with repo scope. Copy it immediately.
Cloudflare Worker

Deploy the Worker

The Worker is your secure API layer. It holds your GitHub token and handles all file operations.

1
Go to dash.cloudflare.com → Workers & Pages → Create → Worker. Name it ace-clouds and deploy.
2
Click Edit Code, paste the contents of worker.js from the repo, click Deploy.
3
Go to Settings → Variables → add the four environment variables below. Encrypt all secrets.
Environment Variables

Worker configuration

Add these four variables to your Cloudflare Worker. Encrypt GITHUB_TOKEN using the toggle in the dashboard.

VariableDescriptionExample
GITHUB_TOKENYour Personal Access Token (encrypt this!)ghp_xxxxxxxxxxxx
GITHUB_OWNERYour GitHub username or organizationVikasPatel22
GITHUB_REPOName of the storage repositoryace-clouds-st
GITHUB_BRANCHBranch to use for storagemain

After deploying to Pages, also add WORKER_URL to your Pages environment variables pointing to your Worker's *.workers.dev URL.

Cloudflare Pages

Deploy the frontend

1
Workers & Pages → Create → Pages → Connect to Git → select your fork of ace-clouds-resources
2
Framework preset: None. Build command: leave empty. Build output: /
3
After first deploy, go to Settings → Environment Variables → add WORKER_URL = your Worker URL, then retry deployment
API Reference

Endpoints

All requests go through /api on your Pages domain — proxied securely to the Worker.

GET /api?list=1 List all files → returns JSON array
GET /api?name=<filename> Download file → returns raw content
POST /api?name=<filename> Upload or overwrite file (body = raw text)
DELETE /api?name=<filename> Delete file permanently

Example cURL commands:

curl -X POST "/api?name=hello.txt" -d "hello" curl "/api?list=1" curl -X DELETE "/api?name=hello.txt"
Infrastructure & Security

Token-safe.
Edge-fast.

Ace Clouds is architecturally secure — your GitHub credentials never touch the browser. Everything sensitive lives inside Cloudflare's encrypted edge runtime.

Powered by Cloudflare

Security isn't an add-on —
it's the architecture.

Every API request runs through Cloudflare Workers deployed across 300+ global data centers. Your GitHub token is stored exclusively as an encrypted Worker environment variable — never sent to or stored in the browser. The Pages Function proxy keeps your Worker URL private and handles CORS cleanly.

Token Never Exposed

GitHub PAT lives only in encrypted Cloudflare Worker env vars. No client-side storage, no cookies, no exposure — ever.

DDoS Protection

Unmetered always-on DDoS mitigation at Cloudflare's global edge. Your storage endpoint stays reachable no matter what.

Zero Cold Start

Cloudflare's edge network runs the Worker globally. API responses reach most users in under 100ms from the nearest PoP.

Private Repo Support

Files in a private GitHub repo are only accessible through authenticated API calls — not via raw GitHub URLs. Your data stays yours.

Proxy Architecture

The Pages Function keeps your Worker URL hidden from users and handles CORS cleanly — no config, no exposure, no leaking URLs.

Add Cloudflare Access

Optionally add Cloudflare Access in front of your Pages site to require SSO login before anyone can reach the UI at all.

Store files.
Pay nothing.

Ace Clouds is open source, free forever, and takes under 10 minutes to deploy. Your GitHub token is safe. Your files are yours.

Fork on GitHub Read the Docs