refactor: overhaul design, UI and architecture for simplicity

- Brand new mono-repo structure with Turbo
- Utilize all of the latest recommendations for LangGraph for agent
- Use CopilotKit's v2 UI's and hooks
- Add ThreeJS example MCP App server to the mono-repo
- Add .env.example
- New README structure
- Restructure components for progressive disclosure of complexity
- Add new "canvas mode" to default UI
- Include new suggestions for guiding and teaching about CopilotKit

Author: tylerslaton

.env.example

@@ -0,0 +1 @@
+OPENAI_API_KEY=

.github/workflows/smoke.yml

@@ -9,14 +9,14 @@ on:
     - cron: "0 0 * * *" # Run daily at midnight UTC
 
 jobs:
-  smoke:
-    name: ${{ matrix.os }} / Node ${{ matrix.node }} / Python ${{ matrix.python }}
+  build-and-test:
+    name: Build & Test - ${{ matrix.os }} / Node ${{ matrix.node }} / Python ${{ matrix.python }}
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest]
-        node: [20, 22]
+        os: [ubuntu-latest, windows-latest]
+        node: [22, 24]
         python: [3.12, 3.13]
 
     steps:
@@ -33,6 +33,9 @@ jobs:
         with:
           python-version: ${{ matrix.python }}
 
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
       - name: Install uv
         uses: astral-sh/setup-uv@v4
         with:
@@ -41,22 +44,20 @@ jobs:
       - name: Configure uv to use matrix Python version
         run: echo "UV_PYTHON=python${{ matrix.python }}" >> $GITHUB_ENV
 
-      - name: Install Node.js dependencies (root)
-        run: npm install
+      - name: Install dependencies (monorepo)
+        run: pnpm install
 
-      - name: Install Node.js dependencies (agent)
-        run: |
-          cd agent
-          npm install
+      - name: Build all apps
+        run: pnpm build
 
-      - name: Build frontend
-        run: npm run build
+      - name: Create empty .env file
+        run: touch .env
 
       - name: Test frontend startup (Linux/macOS)
         if: runner.os != 'Windows'
         run: |
           # Start the Next.js frontend in background
-          npm start &
+          pnpm --filter app start &
           FRONTEND_PID=$!
 
           # Wait for frontend to start (max 30 seconds)
@@ -87,7 +88,7 @@ jobs:
         if: runner.os == 'Windows'
         run: |
           # Start the Next.js frontend in background
-          npm start &
+          pnpm --filter app start &
 
           # Wait for frontend to start (max 30 seconds)
           $timeout = 30
@@ -113,13 +114,32 @@ jobs:
           }
         shell: pwsh
 
+  lint:
+    name: Lint
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+
+      - name: Install dependencies
+        run: pnpm install
+
       - name: Run linting
-        run: npm run lint
+        run: pnpm lint
 
   notify-slack:
     name: Notify Slack on Failure
     runs-on: ubuntu-latest
-    needs: smoke
+    needs: [build-and-test, lint]
     if: |
       failure() &&
       github.event_name == 'schedule'

.gitignore

@@ -1,8 +1,8 @@
 # See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
 
 # dependencies
-/node_modules
-/.pnp
+node_modules
+.pnp
 .pnp.*
 .yarn/*
 !.yarn/patches
@@ -11,14 +11,14 @@
 !.yarn/versions
 
 # testing
-/coverage
+coverage
 
 # next.js
-/.next/
-/out/
+.next/
+out/
 
 # production
-/build
+build
 
 # misc
 .DS_Store
@@ -32,6 +32,7 @@ yarn-error.log*
 
 # env files (can opt-in for committing if needed)
 .env*
+!.env.example
 
 # vercel
 .vercel
@@ -48,3 +49,12 @@ bun.lockb
 
 # LangGraph API
 .langgraph_api
+
+# Git worktrees
+.worktrees
+
+# Turbo
+.turbo
+
+# Tools
+.claude