https://github.com/zygotecode/runreactlocally
The first unique production-ready server that can run React in your machine without touching a Docker container. Made with Node.ts using Bun and the Fastify framework. Supports React Router 100%.
https://github.com/zygotecode/runreactlocally
bun fastify fastify-server fullstack node-server nodejs production-ready react react-csr react-framework react-router typescript web-server
Last synced: about 1 month ago
JSON representation
The first unique production-ready server that can run React in your machine without touching a Docker container. Made with Node.ts using Bun and the Fastify framework. Supports React Router 100%.
- Host: GitHub
- URL: https://github.com/zygotecode/runreactlocally
- Owner: ZygoteCode
- Created: 2025-11-07T20:55:02.000Z (about 2 months ago)
- Default Branch: main
- Last Pushed: 2025-11-07T21:02:33.000Z (about 2 months ago)
- Last Synced: 2025-11-07T23:14:34.365Z (about 2 months ago)
- Topics: bun, fastify, fastify-server, fullstack, node-server, nodejs, production-ready, react, react-csr, react-framework, react-router, typescript, web-server
- Language: TypeScript
- Homepage:
- Size: 1.34 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# ⚡ The First Production-Ready React Server — No Docker. No Compromise.
Welcome to the **first ever production-ready server** that runs **React** directly on your machine — **no Docker**, no complex setup, no bloated toolchains.
Built with **Node.js**, powered by **Bun**, written in **TypeScript**, and running on the **Fastify** framework.
Full support for **React Router 100%**.
This isn’t just another dev toy — it’s a **blazingly fast, production-grade server** that can serve and render your React app **natively**, without relying on Vite or Webpack.
---
## 🚀 Why This Exists
Every React developer knows the pain of:
- Waiting for **Vite** or **Webpack** to spin up.
- Dealing with **Docker containers**, ports, and layer caching.
- Managing **dev servers** that differ from production setups.
This project changes that.
You can now **run your React app natively** on your local machine, with **zero container overhead**, and **real production parity**.
---
## ⚙️ Features
- 🧠 **100% React Router support** — it just works.
- ⚡ **Instant startup** — no bundling, no waiting.
- 🪶 **Lightweight and fast** — thanks to [**Bun**](https://bun.sh/) and [**Fastify**](https://fastify.dev/).
- 🔒 **Production-ready** — same code, same speed, same runtime.
- 🧩 **Fully TypeScript-based** — safe, clean, and modern.
- 🧱 **No Docker, no nonsense** — native performance, zero friction.
---
## ⚡️ Performance vs Vite
| Feature | **This Server** | **Vite** |
|----------|-----------------|----------|
| Startup time | ⚡ Instant | 🕐 Slow (bundling required) |
| Runtime | Native (Bun + Fastify) | Node + dev proxy |
| React Router | ✅ Full support | ✅ Partial in dev mode |
| Docker required | ❌ | Often yes for prod |
| TypeScript support | ✅ Native | ✅ via build step |
| Ideal for | Real-world SSR / production servers | Local development |
---
## 🧠 How It Works
Instead of wrapping your React app inside a development environment, this server:
- Runs React **directly** via Bun’s ultra-fast runtime.
- Uses **Fastify** for HTTP handling and routing.
- Leverages **React Router** for SSR and route handling.
- Delivers production-level performance — even on your laptop.
---
## 🧩 Requirements
- [**Bun**](https://bun.sh/) ≥ 1.1
- Node.js ≥ 20
- TypeScript ≥ 5
---
## 🏁 Getting Started
```bash
# 1. Clone the repository
git clone https://github.com/your-username/your-repo-name.git
cd your-repo-name
# 2. Install dependencies
bun install
# 3. Start the server
bun run server.ts
```
## 🧬 Philosophy
> The web doesn’t need more tools. It needs faster ones.
> This project proves that React can run **natively, instantly**, and **production-ready** — powered only by the latest runtimes.
---
## 🧠 Tech Stack
- ⚡ **Bun** — the lightning-fast JavaScript runtime
- 🏎 **Fastify** — ultra-efficient Node web framework
- ⚛️ **React + React Router** — full client + server rendering
- 🧩 **TypeScript** — strongly typed and maintainable
---
## 💡 Why Not Vite?
Because this isn’t a *dev server*.
This is a **true production server** that runs React instantly, without any build or dev proxy in the middle.
Vite is great — but it’s not production-native.
This project **is**.
---
## 🤖 Commands Summary
| Command | Description |
|----------|-------------|
| `bun install` | Installs dependencies |
| `bun run server.ts` | Starts the Fastify + React server |
| `bun run build` | (Optional) Compile TypeScript to JS |
| `bun test` | (Optional) Run tests |
---
## 🏆 Be Part of the Revolution
You’re looking at **the first-ever production-ready React server** that runs without containers or bundlers.
Fork it. Star it. Break it. Improve it.
Because the future of web servers starts **here**.
---
**Made with ⚡ Bun, ❤️ React, and 🧠 TypeScript.**