Starter template powered by React Router & gr8s server

What is this?

This is a modern, production-ready template with React Router enhanced to optionally work with gr8s.

The simplest way to use it is to clone this repository and modify the sources in app. Follow the Quick Start Guide for more information.

Wait! what is gr8s?

gr8s is an efficient replacement of the conventional node-based server-side rendering (SSR). it does many other things but the main thing is it replaces the need to have a node server.

Why would I want to use gr8s?

because:

🚀 your server suddenly becomes much faster and leaner.

💰 affordable managed hosting or cheaper self hosting.

📈 access to the free SEO editor and analyzer S³ Studio.

🔥 it can even substitute the need for an expensive, chunky CMS

Currently you can write HTML code to be displayed for each page. This could cover your needs (depending on your use case).

Also: a visual page builder is planned, vote for the feature here.

Why shouldn't I use gr8s?

If you prefer to stay in next.js server-side eco system: e.g. if you use server side components, authentication services, or any thing that has to run on a node server, gr8s wouldn't be suitable for you.

Do you want to break free from vendor-lockin? Propose & vote for features you need here. E.g. auth services, webhooks.

Quick Start Guide

Like every frontend app, you will need to install dependencies

pnpm install

Start the development server with hot-module reload (i.e. it updates the site automatically when you edit the sources):

pnpm run dev

Once you are happy with the app and want to deploy it, either:

Deploy to gr8s cloud

Use one of these commands:

• If you need to create a new account

pnpm run gr8s-deploy-signup

• If you already have your site's credentials

pnpm run gr8s-deploy

Both commands will give you a URL where your app is deployed.

Host on your own server

Build your docker image Using the following command (you need to have make installed on your system):

# export APP=<your app name>
make docker-gr8s

Then run the docker image using something like:

docker run --name ${APP}-gr8s -p 8338:8338 -d ${APP}-gr8s

You will need to configure a data source so gr8s can fill your pages. please refere to this guide for a walk through.