gem-hunter
Language: TypeScript
Reference repo for authentication in react-router v7 with middleware, prisma, shadcn and zod v4
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:
This stack uses i18next for internationalization. It supports both client and server side translations. Features included out of the box:
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:
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.
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.
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.
pnpm run dev