Quick Start

Getting started with GAIA is easy. This guide will help you get up and running quickly.

Installation

Make sure you have Node.js >=22.19.0 LTS installed, preferably via nvm.

All you need to do is run this installation command and follow the prompts.

npx create-react-router@latest --template gaia-react/react-router

Install packages

npm install

Setup Fix on Save in your IDE

Follow these instructions.

Development

Duplicate the .env.example file and name it .env.

Storybook

npm run storybook

React Router

npm run dev

Styling

This template comes with Tailwind CSS configured, with some configuration and utilities, which you can change to suit your project.

See the Vite docs on css for more information.

Icons

FontAwesome is included. You're free to change it if you like.

i18n

Remix-i18next is configured with examples.

Storybook is already configured with react-i18n support.

Testing

GAIA comes with a full testing suite already configured.

Unit and Integration

• vitest
• React Testing Library

  npm t
  // or
  npm run test

Visual Regression

Chromatic

You'll need to set your CHROMATIC_PROJECT_TOKEN env variable on your CI.

E2E

PlayWright

npx playwright test

Interactive mode:

npx playwright test --ui

Deployment

GAIA comes with the default React Router 7 deployment configuration. You can change this to whatever deployment process you prefer.

Here's the basic React Router 7 deployment process:

npm run build

Then run the app in production mode:

npm start

You'll need to pick a host to deploy it to. Jacob Paris wrote a great article on where to host your React Router 7 app.

DIY

If you're familiar with deploying Node applications, the built-in React Router 7 app server is production-ready.

Make sure to deploy the output of npm run build

• build/server
• build/client