ore-stack

A React Router template with structured architecture.

Tech Stack

• React Router (Framework mode)
• libSQL + Kysely
• Valibot
• Vitest
• Biome
• TypeScript
• Claude Code
• GitHub Actions
• Docker

Documentation

See docs/ for detailed guidelines:

• docs/guidelines.md - Overall structure and coding conventions
• docs/adapters.md - External system connections
• docs/data.md - Shared data structures
• docs/models.md - Domain logic and data access
• docs/routes.md - HTTP routing and UI
• docs/components.md - Reusable UI components

Usage

pnpm dlx create-react-router@latest my-react-router-app --template https://github.com/oreshinya/ore-stack

Setup

Install dependencies

pnpm install

Remove sample code

pnpm tsx tasks/remove-samples.ts

Run database migrations

pnpm tsx tasks/db.ts up

Development

Start development server

pnpm dev

Type check

pnpm typecheck

Lint and fix

pnpm lint:fix

Run tests

pnpm test

Production

Build

pnpm build

This creates:

• build/ - React Router application (built with Vite)
• dist/ - Server and tasks (built with esbuild)

Start server

pnpm start:server

Run tasks

node dist/tasks-{task-name}.js