frandiox / reactesse-ssr-template

🏕 Opinionated React + Vite Starter Template with SSR in Node.js

Reactesse SSR

React + Vite + SSR template based on @antfu's Vitesse with vite-ssr.

Live Demo

Features

• ⚡️ React, Vite 2, pnpm, ESBuild

• 🗂 File based routing

• 🎨 Windi CSS - on-demand Tailwind CSS with speed

• 😃 SVG icons

• 🌍 I18n ready

• 🗒 Markdown Support

• 🖨 Server-side rendering (SSR) in Node.js via vite-ssr

• 🦾 TypeScript, of course

• ☁️ Deploy on Vercel, minimal config

Pre-packed

UI Frameworks

• Windi CSS (On-demand TailwindCSS) - lighter and faster, with a bundle additional features!
  • Windi CSS Typography - similar to Tailwind CSS Typography but for Windi CSS

Plugins

• vite-plugin-pages - file system based routing
• vite-plugin-windicss - WindiCSS support
• vite-plugin-mdx - Markdown as components / components in Markdown
• remark-prism - Prism for syntax highlighting
• prism-theme-vars - customizable Prism.js theme using CSS variables
• react-i18next - Internationalization
• react-helmet-async - manipulate document head reactively

Dev tools

• TypeScript
• pnpm - fast, disk space efficient package manager
• vite-ssr - Server-side rendering
• Vercel - deploy
• VS Code Extensions
• ESLint

Try it now!

GitHub Template

Create a repo from this template on GitHub.

Clone to local

If you prefer to do it manually with the cleaner git history

npx degit frandiox/reactesse-ssr-template my-reactesse-app
cd my-reactesse-app
pnpm i # If you don't have pnpm installed, run: npm install -g pnpm

Checklist

When you use this template, try follow the checklist to update your info properly

• Add a name field in package.json
• Change the author name in LICENSE
• Change the favicon in public
• Remove the .github folder which contains the funding info
• Clean up the READMEs and remove routes

And, enjoy :)

Usage

Development

Just run and visit http://localhost:3333

pnpm dev # SSR development
pnpm dev:spa # SPA without SSR

Build

To build the App, run

pnpm build

And you will see the generated files in dist, and some of these files will be moved to serverless for deployment.

Deploy on Vercel

Go to Vercel and install its CLI. Then:

pnpm preview # Simulate Vercel environment locally
pnpm deploy
pnpm deploy:prod

reactesse-ssr-template's Issues

"Not found" Message after fresh install

Hi,
After a fresh install using

npx degit frandiox/reactesse-ssr-template my-reactesse-app
cd my-reactesse-app
pnpm i 

I get the follwing message:

[Error]: Failed to resolve entry for package "vitedge"

Flash of unstyled content on fresh install

After doing a fresh install and not changing anything I'm running into a problem of unstyled content when doing the following:

npx degit frandiox/reactesse-ssr-template my-reactesse-app
cd my-reactesse-app
pnpm i 
pnpm dev

About 1-2 seconds later the styles load and display properly.

This is the console output. I do notice that there are also some issues in the package.json and an outdated package?

But those are minor compared to the flash of unstyled content.