chore: initial commit after project scaffolding

Author: arafathusayn

.gitignore

@@ -0,0 +1,2 @@
+/node_modules/
+.turbo

.husky/pre-commit

@@ -0,0 +1 @@
+lint-staged

README.md

@@ -0,0 +1,108 @@
+# React + Tanstack Router + Hono + Drizzle
+
+This project was created with a modern TypeScript stack that combines React, TanStack Router, Hono, tRPC, and more.
+
+## Features
+
+- **TypeScript** - For type safety and improved developer experience
+- **TanStack Router** - File-based routing with full type safety
+- **TailwindCSS** - Utility-first CSS for rapid UI development
+- **shadcn/ui** - Reusable UI components
+- **Hono** - Lightweight, performant server framework
+- **tRPC** - End-to-end type-safe APIs
+- **Bun** - Runtime environment
+- **Drizzle** - TypeScript-first ORM
+- **SQLite/Turso** - Database engine
+- **Authentication** - Email & password authentication with Better Auth
+- **Biome** - Linting and formatting
+- **Husky** - Git hooks for code quality
+
+## Getting Started
+
+First, install the dependencies:
+
+```bash
+bun install
+```
+
+## Database Setup
+
+This project uses SQLite with Drizzle ORM.
+
+1. Start the local SQLite database:
+
+```bash
+cd apps/server && bun db:local
+```
+
+2. Update your `.env` file in the `apps/server` directory with the appropriate connection details if needed.
+
+3. Apply the schema to your database:
+
+```bash
+bun db:push
+```
+
+Then, run the development server:
+
+```bash
+bun dev
+```
+
+Open [http://localhost:3001](http://localhost:3001) in your browser to see the web application.
+
+The API is running at [http://localhost:3000](http://localhost:3000).
+
+## Environment Variables
+
+Create a `.env` file in both **apps/server** and **apps/web** before starting the app. Below are working examples for local development.
+
+### Backend (`apps/server/.env`)
+
+```env
+CORS_ORIGIN=http://localhost:3001
+# Generate a fresh 32‑byte secret for production (see next section)
+BETTER_AUTH_SECRET=kgQjeoklizgXI6FdfANg9VNse0m0ma9E
+BETTER_AUTH_URL=http://localhost:3000
+DATABASE_URL=file:./local.db
+```
+
+### Frontend (`apps/web/.env`)
+
+```env
+VITE_SERVER_URL=http://localhost:3000
+```
+
+### Generating a secure `BETTER_AUTH_SECRET`
+
+Generate a cryptographically‑secure secret with **OpenSSL**:
+
+```bash
+# 32‑byte base64 string (recommended length for production)
+openssl rand -base64 32
+```
+
+Copy the output and paste it into the `BETTER_AUTH_SECRET` entry in your backend `.env` file.
+
+> **Tip:** Regenerate the secret when deploying to a different environment (staging, production, etc.) to isolate sessions across environments.
+
+## Project Structure
+
+```
+react-tanstack-router-hono-drizzle/
+├── apps/
+│   ├── web/         # Frontend application (React + TanStack Router)
+│   └── server/      # Backend API (Hono, tRPC)
+```
+
+## Available Scripts
+
+- `bun dev`: Start all applications in development mode
+- `bun build`: Build all applications
+- `bun dev:web`: Start only the web application
+- `bun dev:server`: Start only the server
+- `bun check-types`: Check TypeScript types across all apps
+- `bun db:push`: Push schema changes to database
+- `bun db:studio`: Open database studio UI
+- `cd apps/server && bun db:local`: Start the local SQLite database
+- `bun check`: Run Biome formatting and linting

apps/server/.gitignore

@@ -0,0 +1,51 @@
+# prod
+dist/
+/build
+/out/
+
+# dev
+.yarn/
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+.vscode/*
+!.vscode/launch.json
+!.vscode/*.code-snippets
+.idea/workspace.xml
+.idea/usage.statistics.xml
+.idea/shelf
+.wrangler
+/.next/
+.vercel
+
+# deps
+node_modules/
+/node_modules
+/.pnp
+.pnp.*
+
+# env
+.env*
+.env.production
+.dev.vars
+
+# logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# misc
+.DS_Store
+*.pem
+
+# local db
+*.db*
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

apps/server/drizzle.config.ts

@@ -0,0 +1,11 @@
+import { defineConfig } from "drizzle-kit";
+
+export default defineConfig({
+  schema: "./src/db/schema",
+  out: "./src/db/migrations",
+  dialect: "turso",
+  dbCredentials: {
+    url: process.env.DATABASE_URL || "",
+    authToken: process.env.DATABASE_AUTH_TOKEN,
+  },
+});

apps/server/package.json

@@ -0,0 +1,32 @@
+{
+	"name": "server",
+	"main": "src/index.ts",
+	"type": "module",
+	"scripts": {
+		"build": "tsc && tsc-alias",
+		"check-types": "tsc --noEmit",
+		"compile": "bun build --compile --minify --sourcemap --bytecode ./src/index.ts --outfile server",
+		"dev": "bun run --hot src/index.ts",
+		"start": "bun run dist/src/index.js",
+		"db:local": "turso dev --db-file local.db",
+		"db:push": "drizzle-kit push",
+		"db:studio": "drizzle-kit studio"
+	},
+	"dependencies": {
+		"dotenv": "^16.4.7",
+		"zod": "^3.24.2",
+		"hono": "^4.7.6",
+		"@hono/trpc-server": "^0.3.4",
+		"drizzle-orm": "^0.38.4",
+		"@libsql/client": "^0.14.0",
+		"better-auth": "^1.2.6",
+		"@trpc/server": "^11.0.0",
+		"@trpc/client": "^11.0.0"
+	},
+	"devDependencies": {
+		"tsc-alias": "^1.8.11",
+		"typescript": "^5.8.2",
+		"@types/bun": "^1.2.6",
+		"drizzle-kit": "^0.30.5"
+	}
+}

apps/server/src/app/api/auth/[...all]/route.ts

@@ -0,0 +1,4 @@
+import { auth } from "@/lib/auth";
+import { toNextJsHandler } from "better-auth/next-js";
+
+export const { GET, POST } = toNextJsHandler(auth.handler);

apps/server/src/db/index.ts

@@ -0,0 +1,9 @@
+import { createClient } from "@libsql/client";
+import { drizzle } from "drizzle-orm/libsql";
+
+const client = createClient({
+  url: process.env.DATABASE_URL || "",
+  authToken: process.env.DATABASE_AUTH_TOKEN,
+});
+
+export const db = drizzle({ client });

apps/server/src/db/schema/auth.ts

@@ -0,0 +1,55 @@
+import { integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
+
+export const user = sqliteTable("user", {
+  id: text("id").primaryKey(),
+  name: text("name").notNull(),
+  email: text("email").notNull().unique(),
+  emailVerified: integer("email_verified", { mode: "boolean" }).notNull(),
+  image: text("image"),
+  createdAt: integer("created_at", { mode: "timestamp" }).notNull(),
+  updatedAt: integer("updated_at", { mode: "timestamp" }).notNull(),
+});
+
+export const session = sqliteTable("session", {
+  id: text("id").primaryKey(),
+  expiresAt: integer("expires_at", { mode: "timestamp" }).notNull(),
+  token: text("token").notNull().unique(),
+  createdAt: integer("created_at", { mode: "timestamp" }).notNull(),
+  updatedAt: integer("updated_at", { mode: "timestamp" }).notNull(),
+  ipAddress: text("ip_address"),
+  userAgent: text("user_agent"),
+  userId: text("user_id")
+    .notNull()
+    .references(() => user.id),
+});
+
+export const account = sqliteTable("account", {
+  id: text("id").primaryKey(),
+  accountId: text("account_id").notNull(),
+  providerId: text("provider_id").notNull(),
+  userId: text("user_id")
+    .notNull()
+    .references(() => user.id),
+  accessToken: text("access_token"),
+  refreshToken: text("refresh_token"),
+  idToken: text("id_token"),
+  accessTokenExpiresAt: integer("access_token_expires_at", {
+    mode: "timestamp",
+  }),
+  refreshTokenExpiresAt: integer("refresh_token_expires_at", {
+    mode: "timestamp",
+  }),
+  scope: text("scope"),
+  password: text("password"),
+  createdAt: integer("created_at", { mode: "timestamp" }).notNull(),
+  updatedAt: integer("updated_at", { mode: "timestamp" }).notNull(),
+});
+
+export const verification = sqliteTable("verification", {
+  id: text("id").primaryKey(),
+  identifier: text("identifier").notNull(),
+  value: text("value").notNull(),
+  expiresAt: integer("expires_at", { mode: "timestamp" }).notNull(),
+  createdAt: integer("created_at", { mode: "timestamp" }),
+  updatedAt: integer("updated_at", { mode: "timestamp" }),
+});

apps/server/src/db/schema/todo.ts

@@ -0,0 +1,7 @@
+import { integer, sqliteTable, text } from "drizzle-orm/sqlite-core";
+
+export const todo = sqliteTable("todo", {
+  id: integer("id").primaryKey({ autoIncrement: true }),
+  text: text("text").notNull(),
+  completed: integer("completed", { mode: "boolean" }).default(false).notNull(),
+});