README.md
Tranzfer
Resumable file delivery for creators and editors. The first milestone is one complete upload, recovery and authorized download flow. See the remaining work.
Development
Install with vp install. Copy .env.example to .env, fill in the values, follow the local serving guide, then run vp run dev.
Use https://tranzfer.localhost. Alchemy runs both Workers locally against a real D1 database and R2 bucket for your dev_<user> stage, so infra/.env needs CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID. Keep auth secrets server-side and register the matching Google OAuth callback for the chosen origin.
Run vp check, vp run test and vp run build before committing. An empty test run is not passing coverage.
Deployment
From the main checkout, run vp run build, inspect vp run plan, then run vp run deploy. The production workflow declares its required GitHub secrets in .github/workflows/deploy.yml.
After deployment, check API /health, web /infra, and sign-in. The infrastructure probe checks D1 and R2 reads. A Worker rollback does not roll back migrations or storage changes.
Decisions
- Vision and product judgment
- Transfer reliability and testing
- Stack and code boundaries
- Solid and Effect
Git and PRs record completed work. Versions and scripts live in package manifests.