Skip to content

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%.

License

Notifications You must be signed in to change notification settings

ZygoteCode/RunReactLocally

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

⚡ 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 and Fastify.
  • 🔒 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 ≥ 1.1
  • Node.js ≥ 20
  • TypeScript ≥ 5

🏁 Getting Started

# 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.

About

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%.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published