05.01 — Igoristan stack#

`package.json`#

{
  "react": "^19.2.3",
  "react-dom": "^19.2.3",
  "vike": "^0.4.258",
  "vike-react": "^0.6.21",
  "valibot": "^1.2.0",
  "react-hook-form": "^7.71.1",
  "@hookform/resolvers": "^5.2.2",
  "react-dropzone": "^14.3.8",
  "lucide-react": "^0.562.0",
  "usehooks-ts": "^3.1.1",
  "throttleit": "^2.1.0",
  "uuid": "^13.0.0",
  "clsx": "^2.1.1",
  "class-variance-authority": "^0.7.1",
  "tailwind-merge": "^3.0.2",
  "tailwindcss-animate": "^1.0.7",
  "@radix-ui/react-slot": "^1.2.4"
}

Lib	Role
React 19.2	UI, hooks
Vike 0.4 + `vike-react`	SSG / SSR framework on top of Vite (formerly “vite-plugin-ssr”)
Valibot 1.2	TS schema validation (lightweight Zod alternative)
react-hook-form	Form handling
react-dropzone	Drag-and-drop upload component
lucide-react	Icons
usehooks-ts	Utility hooks (`useLocalStorage`, etc.), used by `useAuth`
throttleit	Throttle
uuid	ID generation
clsx + tailwind-merge + class-variance-authority	Tailwind utilities

`devDependencies`#

{
  "vite": "^7.3.1",
  "@vitejs/plugin-react": "^5.1.2",
  "@tailwindcss/vite": "^4.1.3",
  "@tailwindcss/postcss": "^4.0.17",
  "tailwindcss": "^4.1.1",
  "terser": "^5.39.0",
  "vite-plugin-compression": "^0.5.1",
  "rollup-plugin-visualizer": "^5.14.0",
  "@qalisa/vike-plugin-sitemap": "^1.7.0",

  "typescript": "^6.0.3",
  "typescript-eslint": "^8.59.0",
  "eslint": "^9.18.0",
  "@eslint/js": "^9.39.2",
  "eslint-plugin-import-x": "^4.6.1",
  "eslint-plugin-perfectionist": "^4.6.0",
  "eslint-plugin-react": "^7.37.4",
  "eslint-plugin-react-hooks": "^5.2.0",
  "eslint-plugin-unused-imports": "^4.2.1",
  "globals": "^15.15.0",

  "prettier": "^3.5.3",
  "prettier-plugin-tailwindcss": "^0.6.11",

  "husky": "^9.1.7",
  "lint-staged": "^15.5.0",
  "commitizen": "^4.3.1",
  "@commitlint/config-conventional": "^19.8.0",
  "@commitlint/cz-commitlint": "^19.8.0",
  "is-ci": "^4.1.0",
  "editorconfig": "^2.0.1",
  "minimatch": "^10.1.1",
  "rimraf": "^6.0.1",
  "wireit": "^0.14.11"
}

`engines`#

{
  "node": "^24.x",
  "pnpm": "11.x"
}

→ Node 24, pnpm 11. packageManager: pnpm@11.x locks the version.

`vite.config.ts`#

const ORIGIN = "https://mojo-molotov.github.io";
const BASE = "/igoristan";
const SITEMAP_EXCLUSIONS = ["**/igoristan/dashboard/**"] as const;

export default defineConfig({
  plugins: [
    react(),
    tailwindcss(),
    viteCompression({ algorithm: "gzip" }),
    viteCompression({ algorithm: "brotliCompress", ext: ".br" }),
    visualizer({ filename: "stats-sunburst.html", template: "treemap" }),
    vike(),
    sitemap({
      sitemapGenerator: (entries) =>
        entries.filter(
          (e) => !minimatch(new URL(e.loc).pathname, SITEMAP_EXCLUSIONS[0]),
        ),
      baseUrl: ORIGIN + BASE,
      pagesDir: "src/pages",
    }),
  ],
  build: {
    terserOptions: {
      compress: { drop_debugger: true, drop_console: true },
    },
    minify: "terser",
  },
  resolve: { alias: { "@": path.resolve(__dirname, "./src") } },
  base: BASE,
});

Plugin	Role
`react()`	JSX + Fast Refresh (HMR)
`tailwindcss()`	Tailwind 4
`viteCompression({gzip})` + `({brotliCompress})`	Pre-compress assets, served by GitHub Pages
`visualizer()`	Generates `stats-sunburst.html` to analyze the bundle
`vike()`	SSG/SSR framework
`sitemap({...})`	Auto-generated sitemap, excludes `/dashboard/**` (auth-protected pages)
`terser`	Minification + `drop_console: true` + `drop_debugger: true`
`@` alias	`@/components/Foo` → `src/components/Foo`
`base: '/igoristan'`	Path prefix for Pages

The `@` alias#

Common in the TS world.
Every project import goes through @/:

import { useAutoPlayAudio } from "@/hooks/useAutoplayAudio";
import { pickRandom } from "@/lib/pickRandom";
import ROUTES from "@/config/routes";
import BRAND from "@/config/brand";

Convention: no relative imports ../../../foo except for assets (../../../assets/gifs/foo.gif).
TS alias in a “personal” project = OK. Best avoided when building an npm lib.

GH Pages deployment#

base: '/igoristan' produces a bundle where every asset is prefixed /igoristan/. That’s what lets it serve from https://mojo-molotov.github.io/igoristan/ without URL patching.

05.01 — Igoristan stack#

package.json#

devDependencies#

engines#

vite.config.ts#