Skip to content

Bracketed/Alfie

Repository files navigation

React + Vite + Hono + Cloudflare Workers

Deploy to Cloudflare

This template provides a minimal setup for building a React application with TypeScript and Vite, designed to run on Cloudflare Workers. It features hot module replacement, ESLint integration, and the flexibility of Workers deployments.

React + TypeScript + Vite + Cloudflare Workers

🚀 Supercharge your web development with this powerful stack:

  • React - A modern UI library for building interactive interfaces
  • Vite - Lightning-fast build tooling and development server
  • Hono - Ultralight, modern backend framework
  • Cloudflare Workers - Edge computing platform for global deployment

✨ Key Features

  • 🔥 Hot Module Replacement (HMR) for rapid development
  • 📦 TypeScript support out of the box
  • 🛠️ ESLint configuration included
  • ⚡ Zero-config deployment to Cloudflare's global network
  • 🎯 API routes with Hono's elegant routing
  • 🔄 Full-stack development setup
  • 🔎 Built-in Observability to monitor your Worker

Get started in minutes with local development or deploy directly via the Cloudflare dashboard. Perfect for building modern, performant web applications at the edge.

Getting Started

To start a new project with this template, run:

npm create cloudflare@latest -- --template=cloudflare/templates/vite-react-template

A live deployment of this template is available at: https://react-vite-template.templates.workers.dev

Development

Install dependencies:

npm install

Start the development server with:

npm run dev

Your application will be available at http://localhost:5173.

Production

Build your project for production:

npm run build

Preview your build locally:

npm run preview

Deploy your project to Cloudflare Workers:

npm run build && npm run deploy

Monitor your workers:

npx wrangler tail

Troubleshooting

Wrangler deploy configuration error

If you encounter an error like:

X [ERROR] There is a deploy configuration at ".wrangler\deploy\config.json".
But the redirected configuration path it points to, "dist\...\wrangler.json", does not exist.

This occurs when Wrangler has cached an outdated deploy configuration. To fix this, run:

npm run clean

Or manually delete the .wrangler/ directory.

Then retry your build or deploy.

Additional Resources

About

A Git registry based on Cloudflare Workers complete with hooks and a small-minimalist UI.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors