____                                ____        __             
   / __ \__  ______  ____              / __ \__  __/ /_______    
  / /_/ / / / / __ `/ __ \    ____    / /_/ / / / / / ___/ _ \   
 / _, _/ /_/ / /_/ / /_/ /   /___/   / ____/ /_/ / (__  )  __/   
/_/ |_|\__, /\__, /\____/           /_/    \__,_/_/____/\___/    
      /____/ /___/                                              
      >> React + RSBuild + Go + GraphQL SSE

rygo-pulse ⚡ The ultimate React 19 + Go boilerplate for lightning-fast GraphQL Subscriptions via SSE

---

🛰️ The Real-Time Heartbeat for Modern Apps

Stop over-engineering with WebSockets for simple data streams. Rygo-Pulse leverages Server-Sent Events (SSE) to "pulse" GraphQL Subscriptions directly from a high-performance Go engine into a React 19 frontend.

This boilerplate is meticulously crafted for Developer Experience and Runtime Efficiency.

✨ See it in Action

Check out the live deployment to experience the high-performance dashboard and real-time signals:

---

💎 Highlights

⚡ RSBuild Speed: Say goodbye to sluggish bundlers. Powered by RSBuild (Rspack-based), get HMR in milliseconds.

⚛️ React 19: Built for the future. Uses the latest hooks and concurrent features for buttery-smooth UI updates.

🐹 Go-Powered: A robust Golang core using gqlgen with a lightweight, thread-safe internal Pub/Sub pattern.

📡 SSE Transport: Native GraphQL Subscriptions over HTTP – firewall-friendly, low-latency, and zero WebSocket overhead.

---

📂 Project Structure

├── backend/                # Golang Service
│   ├── graph/              # GraphQL Schema & Resolvers (gqlgen)
│   │   └── model/          # generate gql models
│   ├── gqlgen.yml          # configuration to generate code 
│   └── server.go           # HTTP/2 Entry Point & Router
├── web/                    # React 19 App
│   ├── src/                # Components, entrypoint and subscription logic
│   │   └── asset/          # Tech stack icons
│   │   └── style/          # CSS styling
│   ├── rsbuild.config.ts   # Optimized Build Configuration
│   └── tsconfig.json       # configuration for TypeScript

---

🚀 Quick Start

• Fire up the Backend

  cd backend
  go mod downloda
  go run .

  If you work on any golang code, i recommend to use a watcher while developing. My favorite is gow. Simple, small and easy. Yet theres a more versatile and configurable watcher called air.

• Ignite the Frontend

  cd web 
  npm install
  npm run dev

Your app is now pulsing at http://localhost:3000.

---

👁️ Want to see a pulse coming to life ?

Open the graphQL Playground that is running on http://localhost:8080 if you did not configured any other listening port.

Post a mutation to create some Todo like this:

mutation {
  createTodo(input: { 
        text: "From grapqhQL Playground", 
        userId: "1234"
        }) {
    id
    text
  }
}

and it will be published to your running frontend. Change the userId to something else that your frontend is not registered as subscriber and no ToDo will be published.

Easy as that.

Your new awesome Application that uses graphQL subscriptions over SSE is ready for takeoff.

---

🛠️ Deep Dive: The SSE Pulse

In this boilerplate, I deliberately avoid graphql-ws. Instead, the backend implements an SSE event stream:

• Client initiates a subscription via a standard HTTP request.
• Go Backend registers a unique channel in the internal Pub/Sub system.
• SSE Handler pipes events into a text/event-stream response.
• React 19 utilizes a streamlined hook to map the stream into the UI state without unnecessary re-renders.

---

🤝 Contributing

Have an idea to make the pulse even faster? PRs are welcome! This project is meant to be a playground and a rock-solid template for the community and everyone who needs some kind of starter for a graphQL powered subscription system.

---

Developed for speed, simplicity, and reliability. Keep the pulse running!