bun

Author: zbeyens

.claude/rules/2-tech-stack.mdc

@@ -12,7 +12,7 @@ Next.js application with Convex backend, Better Auth authentication, and Tailwin
 
 - **TypeScript**
 - **Node.js**: v22
-- **Package Manager**: pnpm
+- **Package Manager**: Bun v1.3.3
 
 ## Frontend
 

.claude/rules/convex-polar.mdc

@@ -740,7 +740,7 @@ export const convertToDatabaseSubscription = (
 
 **File:** `convex/polar/polyfills.ts`
 
-**⚠️ REQUIRED:** Install the `buffer` npm package (`pnpm add buffer`) for Polar SDK to work in Convex.
+**⚠️ REQUIRED:** Install the `buffer` npm package (`bun add buffer`) for Polar SDK to work in Convex.
 
 ```typescript
 import { Buffer as BufferPolyfill } from "buffer";

.claude/ruler.toml renamed to .claude/skiller.toml

@@ -1,14 +1,8 @@
-# Ruler Configuration for Informed Medical
-# This project uses Ruler to manage AI agent instructions
-# Source: .ruler/ directory | Generated: root AGENTS.md, CLAUDE.md, etc.
-
 # Default agents to apply when --agents flag is not specified
 default_agents = ["claude", "cursor", "codex"]
 
 # --- Fork Configuration ---
 
-root_folder = ".claude"
-
 [rules]
 merge_strategy = "cursor"
 
@@ -17,7 +11,6 @@ enabled = false
 
 # --- Global Configuration ---
 
-# Skills support (manages .ruler/skills/ → .claude/skills/ propagation)
 [skills]
 enabled = true
 generate_from_rules = true
@@ -28,7 +21,7 @@ enabled = true
 
 # MCP (Model Context Protocol) server configuration
 [mcp]
-enabled = false  # Disable for now - can enable later if needed
+enabled = true
 merge_strategy = "merge"
 
 # --- Agent-Specific Configuration ---

.github/workflows/ci.yml

@@ -23,46 +23,40 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v5
 
-      - uses: pnpm/action-setup@v3
-        name: Install pnpm
-        id: pnpm-install
+      - uses: oven-sh/setup-bun@v2
+        name: Install bun
         with:
-          version: 8
-          run_install: false
+          bun-version: latest
 
-      - name: Use Node.js 22
+      - name: Use Node.js
         uses: actions/setup-node@v4
         with:
           node-version: 22
-          cache: 'pnpm'
-          cache-dependency-path: '**/pnpm-lock.yaml'
-
-      - name: Get pnpm store directory
-        id: pnpm-cache
-        run: |
-          echo "pnpm_cache_dir=$(pnpm store path)" >> $GITHUB_OUTPUT
 
       - uses: actions/cache@v4
-        name: ♻️ Setup pnpm cache
+        name: ♻️ Setup bun cache
         with:
-          path: ${{ steps.pnpm-cache.outputs.pnpm_cache_dir }}
-          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          path: ~/.bun/install/cache
+          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lock') }}
           restore-keys: |
-            ${{ runner.os }}-pnpm-store-
+            ${{ runner.os }}-bun-
 
       - uses: actions/cache@v4
         name: ♻️ Setup Next.js cache
         with:
           path: ${{ github.workspace }}/.next/cache
-          key: ${{ runner.os }}-nextjs-${{ hashFiles('**/pnpm-lock.yaml') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
+          key: ${{ runner.os }}-nextjs-${{ hashFiles('**/bun.lock') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
           restore-keys: |
-            ${{ runner.os }}-nextjs-${{ hashFiles('**/pnpm-lock.yaml') }}-
+            ${{ runner.os }}-nextjs-${{ hashFiles('**/bun.lock') }}-
 
       - name: 📥 Install
-        run: pnpm install --no-frozen-lockfile && cp .env.example .env.local
+        run: bun install --frozen-lockfile && cp .env.example .env.local
 
-      - name: 🔬 Linter
-        run: pnpm lint && pnpm eslint
+      - name: 🔬 Run Biome & ESLint
+        run: bun lint
 
       - name: 🕵️ Typecheck & Build
-        run: SKIP_ENV_VALIDATION=true pnpm build
+        run: SKIP_ENV_VALIDATION=true bun run build
+
+      # - name: 🧪 Unit tests
+      #   run: bun test

.gitignore

@@ -1,17 +1,11 @@
-!.*
-.git
+.vscode/*
+!.vscode/settings.json
+!.vscode/extensions.json
 
 # See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
 
 # dependencies
 /node_modules
-/.pnp
-.pnp.*
-.yarn/*
-!.yarn/patches
-!.yarn/plugins
-!.yarn/releases
-!.yarn/versions
 
 # testing
 /coverage
@@ -27,12 +21,6 @@
 .DS_Store
 *.pem
 
-# debug
-npm-debug.log*
-yarn-debug.log*
-yarn-error.log*
-.pnpm-debug.log*
-
 # env files (can opt-in for committing if needed)
 .env*
 convex/.env
@@ -47,11 +35,11 @@ next-env.d.ts
 
 .codex
 
-# START Ruler Generated Files
+# START Skiller Generated Files
 /.claude/skills
 /.codex/config.toml
 /.cursor/rules
 /.skillz
 /AGENTS.md
 /CLAUDE.md
-# END Ruler Generated Files
+# END Skiller Generated Files

.vscode/extensions.json

@@ -0,0 +1,10 @@
+{
+  "recommendations": [
+    "unional.vscode-sort-package-json",
+    "biomejs.biome",
+    "dbaeumer.vscode-eslint",
+    "Anthropic.claude-code",
+    "bradlc.vscode-tailwindcss",
+    "oven.bun-vscode"
+  ]
+}

.vscode/settings.json

@@ -30,7 +30,8 @@
   "emmet.showExpandedAbbreviation": "never",
   "editor.codeActionsOnSave": {
     "source.fixAll.biome": "explicit",
-    "source.organizeImports.biome": "explicit"
+    "source.organizeImports.biome": "explicit",
+    "source.sortPackageJson": "explicit"
   },
   "eslint.enable": true,
   "eslint.validate": [

README.md

@@ -30,7 +30,7 @@ A modern Next.js starter template featuring **Convex** backend with **Better Aut
 ### Prerequisites
 
 - Node.js 18 or later
-- pnpm package manager
+- Bun package manager
 - GitHub and/or Google OAuth app credentials
 
 ### Setup Instructions
@@ -40,7 +40,7 @@ A modern Next.js starter template featuring **Convex** backend with **Better Aut
 ```sh
 git clone <your-repo-url>
 cd better-convex
-pnpm install
+bun install
 ```
 
 2. **Set up environment variables:**
@@ -76,15 +76,15 @@ RESEND_API_KEY=your_resend_api_key
 
 ```sh
 # This will start both Next.js and Convex
-pnpm dev
+bun dev
 ```
 
 5. **Initialize Convex environment (first time only):**
 
 In a new terminal:
 
 ```sh
-pnpm sync
+bun sync
 ```
 
 6. **Open the app:**
@@ -94,9 +94,9 @@ Navigate to [http://localhost:3005](http://localhost:3005)
 ### Database Management
 
 ```sh
-pnpm init         # Populate with sample data
-pnpm reset        # Reset all tables
-pnpm studio       # Open Convex dashboard
+bun init         # Populate with sample data
+bun reset        # Reset all tables
+bun studio       # Open Convex dashboard
 ```
 
 ## Custom Convex Functions
@@ -274,14 +274,14 @@ args: {
 ## Development Commands
 
 ```bash
-pnpm dev          # Start dev servers
-pnpm typecheck    # Run TypeScript checks
-pnpm lint         # Check code with Ultracite/Biome
-pnpm lint:fix     # Fix linting and formatting issues
-pnpm check        # Run all checks (lint, ESLint, TypeScript)
-pnpm seed         # Seed database
-pnpm reset        # Reset database
-pnpm studio       # Open Convex dashboard
+bun dev          # Start dev servers
+bun typecheck    # Run TypeScript checks
+bun lint         # Check code with Ultracite/Biome
+bun lint:fix     # Fix linting and formatting issues
+bun check        # Run all checks (lint, ESLint, TypeScript)
+bun seed         # Seed database
+bun reset        # Reset database
+bun studio       # Open Convex dashboard
 ```
 
 ## Best Practices
@@ -481,7 +481,7 @@ After making these changes:
 
 ```bash
 # Regenerate Convex types
-pnpm dev
+bun dev
 ```
 
 This will give you a clean authentication-only starter with: