{"id":29471883,"url":"https://github.com/ifty64bit/hono-react-cloudflare-worker-starter","last_synced_at":"2026-05-02T17:38:20.781Z","repository":{"id":304248287,"uuid":"1012104952","full_name":"ifty64bit/hono-react-cloudflare-worker-starter","owner":"ifty64bit","description":"⚡️ Fullstack starter template with Cloudflare Workers, Hono (API), Vite + React (SPA), and TypeScript. Blazing-fast, edge-ready, and developer-friendly.","archived":false,"fork":false,"pushed_at":"2025-07-22T16:16:59.000Z","size":84,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-07-22T18:13:48.794Z","etag":null,"topics":["cloudflare-workers","edge-computing","hono","react","rpc","spa","turborepo","typescript","vite","web-template"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ifty64bit.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-01T20:24:02.000Z","updated_at":"2025-07-22T16:17:39.000Z","dependencies_parsed_at":"2025-07-11T23:27:38.664Z","dependency_job_id":"8b452751-663b-4a8c-9874-7f808827311b","html_url":"https://github.com/ifty64bit/hono-react-cloudflare-worker-starter","commit_stats":null,"previous_names":["ifty64bit/hono-react-cloudflare-worker-starter"],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/ifty64bit/hono-react-cloudflare-worker-starter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifty64bit%2Fhono-react-cloudflare-worker-starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifty64bit%2Fhono-react-cloudflare-worker-starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifty64bit%2Fhono-react-cloudflare-worker-starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifty64bit%2Fhono-react-cloudflare-worker-starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ifty64bit","download_url":"https://codeload.github.com/ifty64bit/hono-react-cloudflare-worker-starter/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ifty64bit%2Fhono-react-cloudflare-worker-starter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32543962,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T12:25:33.646Z","status":"ssl_error","status_checked_at":"2026-05-02T12:24:51.733Z","response_time":132,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloudflare-workers","edge-computing","hono","react","rpc","spa","turborepo","typescript","vite","web-template"],"created_at":"2025-07-14T14:02:08.343Z","updated_at":"2026-05-02T17:38:20.769Z","avatar_url":"https://github.com/ifty64bit.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🌩️ Cloudflare Worker + Vite + React + SPA FullStack Template\n\nA lightweight fullstack monorepo template using:\n\n-   ⚡️ **Cloudflare Workers** — backend with blazing-fast edge execution\n-   🧩 **Hono** — routing + type-safe API with RPC client\n-   ⚛️ **React + Vite** — modern frontend SPA\n-   📁 **Monorepo structure** — organized workspace with shared code\n-   📦 **TypeScript everywhere** — full type safety across the stack\n-   🔄 **Bun** — fast package manager and runtime\n-   🚀 **Instant deploy** with `wrangler`\n-   ⚡️ **Turborepo** — high-performance build system with smart caching\n\n---\n\n## 📁 Folder Structure\n\n```\n.\n├── api/              # Cloudflare Worker (backend, API)\n│   ├── src/\n│   │   └── index.ts\n│   ├── package.json\n│   └── wrangler.jsonc\n├── web/              # Frontend (Vite + React SPA)\n│   ├── src/\n│   │   ├── App.tsx\n│   │   └── lib/\n│   │       └── api.ts\n│   ├── index.html\n│   └── package.json\n├── shared/           # Shared code between frontend and backend\n│   ├── src/\n│   │   └── index.ts\n│   └── package.json\n├── package.json      # Root scripts for fullstack workflow\n├── bun.lock\n└── tsconfig.json\n```\n\n---\n\n## 🚀 Getting Started\n\n```bash\ngit clone https://github.com/yourname/yourproject.git\ncd yourproject\nbun install\n```\n\n## 🌐 Dev Mode\n\nRun both frontend and backend together:\n\n```bash\nbun run dev\n```\n\nThis will:\n\n-   Start shared library in watch mode\n-   Start Cloudflare Worker via `wrangler dev`\n-   Start Vite dev server for the React frontend\n\n## 🏗️ Build for Production\n\n```bash\nbun run build\n```\n\nThis will:\n\n-   Build shared library\n-   Build backend Worker logic\n-   Build frontend React SPA into `web/dist`\n-   ⚡️ **Turborepo** intelligently caches and parallelizes builds\n\n## 🚀 Deploy to Cloudflare\n\n```bash\nbun run deploy\n```\n\n-   Deploys your Worker + SPA to Cloudflare edge\n-   Static files served from `web/dist`\n-   API routes handled under `/api`\n\n## 📦 Scripts\n\n| Script         | Description                               |\n| -------------- | ----------------------------------------- |\n| `dev`          | Run shared, worker, and frontend together |\n| `build`        | Build all packages with Turborepo caching |\n| `lint`         | Run linting across all packages           |\n| `type-check`   | Run TypeScript type checking              |\n| `test`         | Run tests across all packages             |\n| `clean`        | Clean build artifacts                     |\n| `dev:web`      | Frontend only (Vite dev server)           |\n| `dev:api`      | Worker only (Wrangler)                    |\n| `dev:shared`   | Shared library in watch mode              |\n| `build:web`    | Build frontend only                       |\n| `build:api`    | Build backend only                        |\n| `build:shared` | Build shared library only                 |\n| `deploy`       | Deploy to Cloudflare                      |\n| `cf-typegen`   | Generate types for environment            |\n\n## 🧪 Example Routes\n\n| Route             | Type        | Description           |\n| ----------------- | ----------- | --------------------- |\n| `/`               | Frontend    | React SPA entry point |\n| `/api/health`     | Backend API | Health check endpoint |\n| `/api/auth/login` | Backend API | Sample login route    |\n\n🔒 All `/api/*` routes are handled by your Worker (run_worker_first)\n\n## 🧠 Features\n\n-   ✅ Full TypeScript support\n-   ✅ Type-safe Hono RPC client (via hc\u003cAppType\u003e())\n-   ✅ SPA fallback (index.html) for frontend routing\n-   ✅ Dev-first workflow with hot reloading\n-   ✅ Fast Cloudflare edge deployment\n-   ✅ Monorepo structure with shared code\n-   ✅ Path aliases for clean imports\n-   ✅ **Turborepo** for intelligent caching and parallel execution\n\n## 🧰 Tools Used\n\n-   **Cloudflare Workers** — Serverless backend runtime\n-   **Wrangler** — CLI for Cloudflare Workers\n-   **Hono** — Fast, lightweight web framework\n-   **React** — Frontend UI library\n-   **Vite** — Fast build tool and dev server\n-   **TypeScript** — Type-safe JavaScript\n-   **Bun** — Fast package manager and runtime\n-   **Turborepo** — High-performance build system with smart caching\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fifty64bit%2Fhono-react-cloudflare-worker-starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fifty64bit%2Fhono-react-cloudflare-worker-starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fifty64bit%2Fhono-react-cloudflare-worker-starter/lists"}