update to next 16

Makefile

@@ -5,20 +5,16 @@ scripts_dir := ./scripts
 help:
 	@cat $(scripts_dir)/help.txt
 
-.PHONY: setup_compose
-setup_compose:
-	$(scripts_dir)/setup_compose.sh
-
-.PHONY: build
-build: setup_compose
-	$(compose) build
-
-.PHONY: setup_web
-setup_web: build
-	$(scripts_dir)/setup_web.sh
+# Native
+.PHONY: dev
+dev:
+	@$(scripts_dir)/setup_native.sh
+	cd web && pnpm run dev
 
+# Docker Compose
 .PHONY: up
-up: setup_web
+up:
+	@$(scripts_dir)/setup_compose.sh
 	$(compose) up -d
 
 .PHONY: down
@@ -33,3 +29,4 @@ logs:
 shell:
 	$(compose) run --rm web bash
 
+

README.md

@@ -4,13 +4,23 @@
 
 ## Run
 
+Choose your preferred development environment:
+
+### Native
+
+```bash
+make dev
+```
+
+### Docker Compose
+
 ```bash
-make
+make up
 ```
 
 ## Tech Stack
 
-- Docker Compose
 - TypeScript
+- React
 - Next.js
 - MDX

scripts/help.txt

@@ -1,9 +1,13 @@
 usage: make [command]
+
+General:
   help:           Show this help message
-  up:             Launch the project in detached mode
-  setup_web:      Prepare the web container for development
-  build:          Build the project using docker compose
-  setup_compose:  Run initial setup scripts for docker compose
-  down:           Take down the containers
-  logs:           Follow logs
+
+Native:
+  dev:            Set up and start the development server natively
+
+Docker Compose:
+  up:             Set up and start the development server in Docker
+  down:           Stop the Docker containers
+  logs:           Follow Docker container logs
   shell:          Open a bash shell in the web container

scripts/setup_compose.sh

@@ -1,6 +1,20 @@
-#!/bin/env bash
+#!/usr/bin/env bash
+
+set -e
+
+echo "Setting up docker compose environment..."
 
 if [ ! -f compose.override.yaml ]; then
-  echo "compose.override.yaml not found, creating from example"
+  echo "Creating compose.override.yaml..."
   cp compose.override.example.yaml compose.override.yaml
 fi
+
+echo "Building containers..."
+docker compose build
+
+if [ ! -d web/node_modules ]; then
+  echo "Installing dependencies in container..."
+  docker compose run --rm web pnpm install
+fi
+
+echo "Docker compose setup complete!"

scripts/setup_native.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+
+set -e
+
+echo "Setting up native environment..."
+
+cd web
+
+if ! command -v pnpm &> /dev/null; then
+  echo "Error: pnpm is not installed"
+  exit 1
+fi
+
+if [ ! -d node_modules ]; then
+  echo "Installing dependencies..."
+  pnpm install
+fi
+
+echo "Native setup complete!"

web/next-env.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
-/// <reference path="./.next/types/routes.d.ts" />
+import "./.next/dev/types/routes.d.ts";
 
 // NOTE: This file should not be edited
 // see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

web/next.config.ts

@@ -2,6 +2,7 @@ import createMDX from "@next/mdx";
 import type { NextConfig } from "next";
 
 const nextConfig: NextConfig = {
+	cacheComponents: true,
 	experimental: {
 		// typedRoutes: true,
 		// mdxRs: true,

web/package.json

@@ -3,8 +3,8 @@
 	"version": "1.0.0",
 	"private": true,
 	"scripts": {
-		"dev": "next dev --turbopack -p 4200",
-		"build": "next build --turbopack",
+		"dev": "next dev -p 4200",
+		"build": "next build",
 		"start": "next start -p 4200",
 		"lint": "biome lint",
 		"lint:fix": "biome lint --write",
@@ -21,7 +21,7 @@
 		"@highlightjs/cdn-assets": "^11.11.1",
 		"@mdx-js/loader": "^3.1.1",
 		"@mdx-js/react": "^3.1.1",
-		"@next/mdx": "^15.5.4",
+		"@next/mdx": "16.0.3",
 		"@radix-ui/react-accordion": "^1.2.12",
 		"@radix-ui/react-label": "^2.1.7",
 		"@radix-ui/react-radio-group": "^1.3.8",
@@ -35,19 +35,19 @@
 		"@types/mdx": "^2.0.13",
 		"@types/node": "^24.6.0",
 		"@types/papaparse": "^5.3.16",
-		"@types/react": "^19.1.16",
-		"@types/react-dom": "^19.1.9",
+		"@types/react": "19.2.5",
+		"@types/react-dom": "19.2.3",
 		"@types/three": "^0.180.0",
 		"class-variance-authority": "^0.7.1",
 		"clsx": "^2.1.1",
 		"katex": "^0.16.22",
 		"lucide-react": "^0.544.0",
-		"next": "^15.5.4",
+		"next": "16.0.3",
 		"next-themes": "^0.4.6",
 		"papaparse": "^5.5.3",
 		"postcss": "^8.5.6",
-		"react": "^19.1.1",
-		"react-dom": "^19.1.1",
+		"react": "19.2.0",
+		"react-dom": "19.2.0",
 		"recharts": "^3.2.1",
 		"rehype-autolink-headings": "^7.1.0",
 		"rehype-highlight": "^7.0.2",
@@ -65,5 +65,15 @@
 	"devDependencies": {
 		"@biomejs/biome": "2.2.4"
 	},
-	"packageManager": "pnpm@10.18.1+sha512.77a884a165cbba2d8d1c19e3b4880eee6d2fcabd0d879121e282196b80042351d5eb3ca0935fa599da1dc51265cc68816ad2bddd2a2de5ea9fdf92adbec7cd34"
+	"packageManager": "pnpm@10.18.1+sha512.77a884a165cbba2d8d1c19e3b4880eee6d2fcabd0d879121e282196b80042351d5eb3ca0935fa599da1dc51265cc68816ad2bddd2a2de5ea9fdf92adbec7cd34",
+	"pnpm": {
+		"overrides": {
+			"@types/react": "19.2.5",
+			"@types/react-dom": "19.2.3"
+		},
+		"onlyBuiltDependencies": [
+			"@tailwindcss/oxide",
+			"sharp"
+		]
+	}
 }