v2.4.0: Migrate to Cloudflare Workers + feature additions

Author: jacc

apps/stardew.app/.env.local.example .env.local.exampleapps/stardew.app/.env.local.example renamed to .env.local.example

@@ -0,0 +1,18 @@
+module.exports = {
+	extends: ["plugin:@typescript-eslint/recommended", "next/core-web-vitals"],
+	parser: "@typescript-eslint/parser",
+	plugins: ["@typescript-eslint"],
+	root: true,
+	rules: {
+		"@typescript-eslint/consistent-type-imports": [
+			"error",
+			{
+				prefer: "type-imports",
+				fixStyle: "inline-type-imports",
+			},
+		],
+		"@typescript-eslint/no-explicit-any": 0,
+		"@typescript-eslint/no-require-imports": 0,
+		"@typescript-eslint/no-empty-interface": 0,
+	},
+};

.eslintrc.cjs

@@ -5,17 +5,14 @@ on: [push, pull_request]
 jobs:
   Format:
     runs-on: ubuntu-latest
-    env:
-      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
-      TURBO_TEAM: ${{ vars.TURBO_TEAM }}
 
     steps:
       - uses: actions/checkout@v4
 
       - uses: oven-sh/setup-bun@v1
 
       - name: Install modules
-        run: bun install
+        run: bun install --frozen-lockfile
 
       - name: Run Format
         run: bun run format

.github/workflows/format.yml

@@ -5,17 +5,13 @@ on: [push, pull_request]
 jobs:
   Lint:
     runs-on: ubuntu-latest
-    env:
-      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
-      TURBO_TEAM: ${{ vars.TURBO_TEAM }}
-
     steps:
       - uses: actions/checkout@v4
 
       - uses: oven-sh/setup-bun@v1
 
       - name: Install modules
-        run: bun install
+        run: bun install --frozen-lockfile
 
       - name: Run ESLint
         run: bun run lint

.github/workflows/lint.yml

@@ -5,17 +5,13 @@ on: [push, pull_request]
 jobs:
   Typecheck:
     runs-on: ubuntu-latest
-    env:
-      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}
-      TURBO_TEAM: ${{ vars.TURBO_TEAM }}
-
     steps:
       - uses: actions/checkout@v4
 
       - uses: oven-sh/setup-bun@v1
 
       - name: Install modules
-        run: bun install
+        run: bun install --frozen-lockfile
 
       - name: Run Typecheck
         run: bun run typecheck

.github/workflows/test.yml

@@ -1,17 +1,26 @@
 node_modules
 .next/
+.open-next/
+.wrangler/
 out/
 .DS_Store
 *.pem
 npm-debug.log*
+package-lock.json
 .env
-.env.local
+.env.*
 .vercel
 *.tsbuildinfo
 next-env.d.ts
 .turbo
 venv
 .venv
 __pycache__/
-.sentryclirc
-.env.sentry-build-plugin
+.env*.local
+.dev.vars*
+AGENTS.md
+cloudflare-env.d.ts
+.agents/
+.claude/
+dist/
+scripts/**/*.json

.github/workflows/typecheck.yml

@@ -16,10 +16,10 @@ The website uses [Next.js](https://nextjs.org) for its frontend, self-hosted MyS
     <img align=center src="https://github.com/communitycenter/stardew.app/blob/main/.github/info.png?raw=true" alt="Stardew.app Logo" width="500" /></br>
 </p>
 
-| Feature                         |     | Notes                |
-| ------------------------------- | --- | -------------------- |
+| Feature                         |     | Notes |
+| ------------------------------- | --- | ----- |
 | 100% perfection tracking        | ✅  |
-| All 1.6 content                 | ⚠️  | Missing animals page |
+| All 1.6 content                 | ✅  |
 | Achievement tracking            | ✅  |
 | Fish tracker with location info | ✅  |
 | Shipping tracker with crop info | ✅  |
@@ -245,9 +245,28 @@ Below are some incredible people that the website wouldn't be without today.
 
 ---
 
-## Local Database Setup
+## Local Development Setup
 
-1. Copy `apps/stardew.app/.env.local.example` to `apps/stardew.app/.env.local` and update the MySQL credentials.
-2. Run `bun install` to install project dependencies.
+1. Run `bun install` to install project dependencies.
+2. Copy `.env.local.example` to `.env.local` and update the MySQL credentials.
 3. Ensure MySQL is running locally.
-4. Run `bun run prepLocalEnv` to create the database and sync the schema for local testing.
+4. Run `bun run prepLocalEnv` to create the database and sync the schema.
+5. Run `bun run dev` to start the Next.js dev server at http://localhost:3000.
+
+### Testing against Cloudflare Workers locally
+
+`bun run dev` runs a standard Next.js dev server — fast for iteration, but it does not emulate the Cloudflare runtime. To test with the actual Workers runtime locally (Hyperdrive bindings, etc.), use:
+
+```
+bun run preview
+```
+
+This builds the OpenNext Cloudflare bundle and runs it via Wrangler's local dev environment.
+
+### Deploying
+
+```
+bun run deploy
+```
+
+This builds the OpenNext bundle and deploys it to Cloudflare Workers via Wrangler.