Welcome to Forge 42 base-stack

This is a base-stack for Forge 42 projects. This stack is a starting point for all Forge 42 stacks with more advanced features. This is an ESM Vite stack with Remix.run / React Router v7.

It includes a basic setup for a project with react-router v7 framework mode and:

React 19 & react-compiler
TypeScript
TailwindCSS
Vite
Vitest (unit tests)
Scripting
Biome (linter & formatter)
i18n support (client and server)
Icons spritesheet generator
lefthook hooks
CI checks for quality control
react-router-devtools
Hono server
.env var handling for server and client
SEO robots.txt, sitemap-index and sitemap built in.

Internationalization

This stack uses i18next for internationalization. It supports both client and server side translations. Features included out of the box:

Support for multiple languages
Typesafe resources
client side translations are fetched only when needed
language switcher
language detector (uses the request to detect the language, falls back to your fallback language)

Hono server

This stack uses Hono for the server. More information about Hono can be found here. Another important thing to note is that we use a dependency called react-router-hono-server which is a wrapper for Hono that allows us to use Hono in our React Router application.

The server comes preconfigured with:

i18next middleware
caching middleware for assets
easily extendable global application context
.env injection into context

In order to add your own middleware, extend the context, or anything along those lines, all you have to do is edit the server inside the entry.server.tsx file.

.env handling

This stack parses your .env file and injects it into the server context. For the client side, in the root.tsx file, we use the useLoaderData hook to get the clientEnv from the server and set it as a global variable on the window called env. If you need to access the env variables in both environments, you can create a polyEnv helper like this:

// app/utils/env.ts
// This will return the process.env on the server and window.env on the client
export const polyEnv = typeof process !== "undefined" ? process.env : window.env;

The server will fail at runtime if you don't set your .env file properly.

Getting started

Fork the repository
Install the dependencies:

pnpm install

Read through the README.md files in the project to understand our decisions.
Run the cleanup script:

pnpm cleanup

This will remove everything in the project related to the base-stack like README.md etc. This is the first thing you should run after initializing the project. After it is run it will remove itself from the package.json.

Start the development server:

pnpm run dev

Happy coding!

License

ourines/base-stack

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Languages

Error
Looks like something went wrong!

Packages