Edgeapps

Languages: English | 中文

A collection of edge applications for Cloudflare Workers and EdgeOne Pages.

Apps

• apps/gh-proxy: GitHub proxy with raw/api/git clone acceleration.
• apps/short-url: URL shortener with KV storage.
• apps/npm-registry: Private npm registry with R2 storage (Cloudflare-only).

Packages

• packages/core: Shared proxy/auth/owners logic.

Docs

• docs/platform-limits.md: Cloudflare / EdgeOne / KV / D1 / Supabase free vs paid limits comparison.

Release

gh-proxy

pnpm install
cp edgeapps/apps/gh-proxy/gh-proxy.env.example ./gh-proxy.env
# Edit gh-proxy.env with your values
pnpm -F gh-proxy release

Use -o cf|eo for single target.

short-url

pnpm install
cp edgeapps/apps/short-url/short-url.env.example ./short-url.env
# Edit short-url.env with your values
pnpm -F short-url release

Before first release, create Pages project in CF Dashboard and configure KV bindings and environment variables.

npm-registry

pnpm install
cp edgeapps/apps/npm-registry/npm-registry.env.example ./npm-registry.env
# Edit npm-registry.env with your values
pnpm -F npm-registry release

Configure NPM_BUCKET (R2) + AUTH_KV (KV) bindings in Cloudflare Pages before first release.

Smoke tests

cp apps/gh-proxy/scripts/gh-proxy-smoke.env.example ./gh-proxy-smoke.env
bash apps/gh-proxy/scripts/gh-proxy-smoke.sh

cp apps/npm-registry/scripts/npm-registry-smoke.env.example ./npm-registry-smoke.env
bash apps/npm-registry/scripts/npm-registry-smoke.sh

See each app's README for detailed deployment and configuration.