insforge 1.2.10 → 1.4.8

package/docs/quickstart.mdx

@@ -1,83 +1,83 @@
----
-title: "Quickstart"
-description: "Get Insforge running in 5 minutes"
----
-
-Choose your deployment method:
-
-<Tabs>
-  <Tab title="Cloud Platform">
-    ## Get started in three steps (Cloud)
-
-    ### Step 1: Create your project
-    
-    <Card title="Go to Insforge Cloud" icon="cloud" href="https://insforge.dev">
-      Visit [insforge.dev](https://insforge.dev) and create a free account
-    </Card>
-    
-    Once logged in:
-    1. Click **"Create New Project"**
-    2. Your backend will be ready in ~3 seconds
-
-    ### Step 2: Connect to InsForge MCP Server
-
-    <img src="/images/onboarding-mcp.png" alt="InsForge MCP Installation" />
-
-    In your project dashboard:
-    1. Choose your IDE (Cursor, Claude Code, Windsurf, Cline, etc.)
-    2. Copy the installation command - it includes your API key and URL automatically
-    3. Run the command in your terminal
-
-    Example command (yours will have your actual API key and URL):
-    ```bash
-    npx @insforge/install --client cursor \
-      --env API_KEY=ik_your_actual_api_key_here \
-      --env API_BASE_URL=https://your-app.us-east.insforge.app
-    ```
-
-    4. Test in your coding IDE by asking: "InsForge is my backend platform, what is my current backend structure?"
-
-    ### Step 3: Build your first app
-
-    Check out our [framework examples](/examples/overview) for step-by-step guides on building with:
-    - Next.js
-    - React
-    - Vue
-    - Nuxt
-    - Svelte
-
-    Or tell your AI assistant to build something:
-
-    ```
-    "Build a todo app with user authentication using Insforge as the backend"
-    ```
-
-    Your AI will automatically:
-    - Create database tables
-    - Set up authentication
-    - Handle file uploads
-    - Generate a complete frontend
-  </Tab>
-  
-  <Tab title="Local Development">
-    ## Run Insforge locally
-    
-    For local development and self-hosting instructions, please visit the official OSS repository:
-    
-    <Card title="Insforge OSS Repository" icon="github" href="https://github.com/insforge/insforge">
-      **Complete local setup guide available at:**
-      
-      https://github.com/insforge/insforge
-      
-      The repository includes:
-      - Docker setup instructions
-      - Environment configuration
-      - AI agent integration guides
-      - Troubleshooting tips
-    </Card>
-    
-    <Note>
-      Local development requires Docker and provides the same features as the cloud platform.
-    </Note>
-  </Tab>
+---
+title: "Quickstart"
+description: "Get InsForge running in 5 minutes"
+---
+
+Choose your deployment method:
+
+<Tabs>
+  <Tab title="Cloud Platform">
+    ## Get started in three steps (Cloud)
+
+    ### Step 1: Create your project
+    
+    <Card title="Go to Insforge Cloud" icon="cloud" href="https://insforge.dev">
+      Visit [insforge.dev](https://insforge.dev) and create a free account
+    </Card>
+    
+    Once logged in:
+    1. Click **"Create New Project"**
+    2. Your backend will be ready in ~3 seconds
+
+    ### Step 2: Connect to InsForge MCP Server
+
+    <img src="/images/onboarding-mcp.png" alt="InsForge MCP Installation" />
+
+    In your project dashboard:
+    1. Choose your IDE (Cursor, Claude Code, Windsurf, Cline, etc.)
+    2. Copy the installation command - it includes your API key and URL automatically
+    3. Run the command in your terminal
+
+    Example command (yours will have your actual API key and URL):
+    ```bash
+    npx @insforge/install --client cursor \
+      --env API_KEY=ik_your_actual_api_key_here \
+      --env API_BASE_URL=https://your-app.us-east.insforge.app
+    ```
+
+    4. Test in your coding IDE by asking: "InsForge is my backend platform, what is my current backend structure?"
+
+    ### Step 3: Build your first app
+
+    Check out our [framework examples](/examples/overview) for step-by-step guides on building with:
+    - Next.js
+    - React
+    - Vue
+    - Nuxt
+    - Svelte
+
+    Or tell your AI assistant to build something:
+
+    ```
+    "Build a todo app with user authentication using Insforge as the backend"
+    ```
+
+    Your AI will automatically:
+    - Create database tables
+    - Set up authentication
+    - Handle file uploads
+    - Generate a complete frontend
+  </Tab>
+  
+  <Tab title="Local Development">
+    ## Run Insforge locally
+    
+    For local development and self-hosting instructions, please visit the official OSS repository:
+    
+    <Card title="Insforge OSS Repository" icon="github" href="https://github.com/insforge/insforge">
+      **Complete local setup guide available at:**
+      
+      https://github.com/insforge/insforge
+      
+      The repository includes:
+      - Docker setup instructions
+      - Environment configuration
+      - AI agent integration guides
+      - Troubleshooting tips
+    </Card>
+    
+    <Note>
+      Local development requires Docker and provides the same features as the cloud platform.
+    </Note>
+  </Tab>
 </Tabs>

package/docs/showcase.mdx

@@ -1,52 +1,52 @@
----
-title: Showcase
-description: Production applications built with InsForge
----
-
-import { ServiceIcons } from '/snippets/service-icons.mdx';
-
-See what developers are building with InsForge - from AI-powered SaaS to social platforms and beyond.
-
-## Community Projects
-
-<CardGroup cols={2}>
-  <Card title="National Flags Leaderboard" icon="flag" href="https://national-flags-phi.vercel.app/">
-    <div style={{maxHeight: '192px', height: '192px', overflow: 'hidden', borderRadius: '0.5rem', pointerEvents: 'none'}}>
-      <img src="/showcase/national-flags.png" style={{width: '100%', height: '192px', objectFit: 'cover', pointerEvents: 'none'}} alt="National Flags Leaderboard showcase" />
-    </div>
-
-    Learn national flags through an interactive database and take on challenges with real-time leaderboard rankings.
-
-    <ServiceIcons services={['database', 'auth', 'storage', 'ai', 'functions']} />
-  </Card>
-
-  <Card title="Pokemon Vibe" icon="wand-magic-sparkles" href="https://pokemon-vibe.vercel.app/">
-    <div style={{maxHeight: '192px', height: '192px', overflow: 'hidden', borderRadius: '0.5rem', pointerEvents: 'none'}}>
-      <img src="/showcase/pokemon-vibe.png" style={{width: '100%', height: '192px', objectFit: 'cover', pointerEvents: 'none'}} alt="Pokemon Vibe showcase" />
-    </div>
-
-    Form your own Pokemon teams and compete against others. AI-powered battles let two teams fight on top of AI-generated drawings.
-
-    <ServiceIcons services={['database', 'auth', 'storage', 'ai', 'functions']} />
-  </Card>
-
-  <Card title="2048 Arena" icon="gamepad" href="https://insforge-2048-arena.netlify.app/">
-    <div style={{maxHeight: '192px', height: '192px', overflow: 'hidden', borderRadius: '0.5rem', pointerEvents: 'none'}}>
-      <img src="/showcase/2048-arena.png" style={{width: '100%', height: '192px', objectFit: 'cover', pointerEvents: 'none'}} alt="2048 Arena showcase" />
-    </div>
-
-    Classic 2048 puzzle game with multiplayer arena and competitive leaderboards.
-
-    <ServiceIcons services={['database', 'auth']} />
-  </Card>
-
-  <Card title="Line Connect Race" icon="route" href="https://line-connect-race.vercel.app/">
-    <div style={{maxHeight: '192px', height: '192px', overflow: 'hidden', borderRadius: '0.5rem', pointerEvents: 'none'}}>
-      <img src="/showcase/line-connect-race.png" style={{width: '100%', height: '192px', objectFit: 'cover', pointerEvents: 'none'}} alt="Line Connect Race showcase" />
-    </div>
-
-    Interactive line-drawing racing game with real-time multiplayer and competitive gameplay.
-
-    <ServiceIcons services={['database', 'auth', 'functions']} />
-  </Card>
-</CardGroup>
+---
+title: Showcase
+description: Production applications built with InsForge
+---
+
+import { ServiceIcons } from '/snippets/service-icons.mdx';
+
+See what developers are building with InsForge - from AI-powered SaaS to social platforms and beyond.
+
+## Community Projects
+
+<CardGroup cols={2}>
+  <Card title="National Flags Leaderboard" icon="flag" href="https://national-flags-phi.vercel.app/">
+    <div style={{maxHeight: '192px', height: '192px', overflow: 'hidden', borderRadius: '0.5rem', pointerEvents: 'none'}}>
+      <img src="/showcase/national-flags.png" style={{width: '100%', height: '192px', objectFit: 'cover', pointerEvents: 'none'}} alt="National Flags Leaderboard showcase" />
+    </div>
+
+    Learn national flags through an interactive database and take on challenges with real-time leaderboard rankings.
+
+    <ServiceIcons services={['database', 'auth', 'storage', 'ai', 'functions']} />
+  </Card>
+
+  <Card title="Pokemon Vibe" icon="wand-magic-sparkles" href="https://pokemon-vibe.vercel.app/">
+    <div style={{maxHeight: '192px', height: '192px', overflow: 'hidden', borderRadius: '0.5rem', pointerEvents: 'none'}}>
+      <img src="/showcase/pokemon-vibe.png" style={{width: '100%', height: '192px', objectFit: 'cover', pointerEvents: 'none'}} alt="Pokemon Vibe showcase" />
+    </div>
+
+    Form your own Pokemon teams and compete against others. AI-powered battles let two teams fight on top of AI-generated drawings.
+
+    <ServiceIcons services={['database', 'auth', 'storage', 'ai', 'functions']} />
+  </Card>
+
+  <Card title="2048 Arena" icon="gamepad" href="https://insforge-2048-arena.netlify.app/">
+    <div style={{maxHeight: '192px', height: '192px', overflow: 'hidden', borderRadius: '0.5rem', pointerEvents: 'none'}}>
+      <img src="/showcase/2048-arena.png" style={{width: '100%', height: '192px', objectFit: 'cover', pointerEvents: 'none'}} alt="2048 Arena showcase" />
+    </div>
+
+    Classic 2048 puzzle game with multiplayer arena and competitive leaderboards.
+
+    <ServiceIcons services={['database', 'auth']} />
+  </Card>
+
+  <Card title="Line Connect Race" icon="route" href="https://line-connect-race.vercel.app/">
+    <div style={{maxHeight: '192px', height: '192px', overflow: 'hidden', borderRadius: '0.5rem', pointerEvents: 'none'}}>
+      <img src="/showcase/line-connect-race.png" style={{width: '100%', height: '192px', objectFit: 'cover', pointerEvents: 'none'}} alt="Line Connect Race showcase" />
+    </div>
+
+    Interactive line-drawing racing game with real-time multiplayer and competitive gameplay.
+
+    <ServiceIcons services={['database', 'auth', 'functions']} />
+  </Card>
+</CardGroup>

package/docs/snippets/sdk-installation.mdx

@@ -1,22 +1,22 @@
-<CodeGroup>
-```bash npm
-npm install @insforge/sdk@latest
-```
-
-```bash yarn
-yarn add @insforge/sdk@latest
-```
-
-```bash pnpm
-pnpm add @insforge/sdk@latest
-```
-</CodeGroup>
-
-```javascript
-import { createClient } from '@insforge/sdk';
-
-const insforge = createClient({
-  baseUrl: 'https://your-app.us-east.insforge.app',
-  anonKey: 'your-anon-key'  // Optional: for public/unauthenticated requests
-});
+<CodeGroup>
+```bash npm
+npm install @insforge/sdk@latest
+```
+
+```bash yarn
+yarn add @insforge/sdk@latest
+```
+
+```bash pnpm
+pnpm add @insforge/sdk@latest
+```
+</CodeGroup>
+
+```javascript
+import { createClient } from '@insforge/sdk';
+
+const insforge = createClient({
+  baseUrl: 'https://your-app.us-east.insforge.app',
+  anonKey: 'your-anon-key'  // Optional: for public/unauthenticated requests
+});
 ```

package/docs/snippets/service-icons.mdx

@@ -1,27 +1,27 @@
-export const ServiceIcons = ({ services }) => {
-  const iconMap = {
-    database: { src: '/images/icons/database.svg', title: 'Database' },
-    auth: { src: '/images/icons/auth.svg', title: 'Authentication' },
-    storage: { src: '/images/icons/storage.svg', title: 'Storage' },
-    ai: { src: '/images/icons/ai.svg', title: 'AI Services' },
-    functions: { src: '/images/icons/function.svg', title: 'Edge Functions' }
-  };
-
-  return (
-    <div className="flex gap-2 mt-3" style={{pointerEvents: 'none'}}>
-      {services.map((service) => {
-        const icon = iconMap[service.toLowerCase()];
-        return icon ? (
-          <img
-            key={service}
-            src={icon.src}
-            alt={icon.title}
-            title={icon.title}
-            className="w-5 h-5 opacity-70"
-            style={{pointerEvents: 'none'}}
-          />
-        ) : null;
-      })}
-    </div>
-  );
-};
+export const ServiceIcons = ({ services }) => {
+  const iconMap = {
+    database: { src: '/images/icons/database.svg', title: 'Database' },
+    auth: { src: '/images/icons/auth.svg', title: 'Authentication' },
+    storage: { src: '/images/icons/storage.svg', title: 'Storage' },
+    ai: { src: '/images/icons/ai.svg', title: 'AI Services' },
+    functions: { src: '/images/icons/function.svg', title: 'Edge Functions' }
+  };
+
+  return (
+    <div className="flex gap-2 mt-3" style={{pointerEvents: 'none'}}>
+      {services.map((service) => {
+        const icon = iconMap[service.toLowerCase()];
+        return icon ? (
+          <img
+            key={service}
+            src={icon.src}
+            alt={icon.title}
+            title={icon.title}
+            className="w-5 h-5 opacity-70"
+            style={{pointerEvents: 'none'}}
+          />
+        ) : null;
+      })}
+    </div>
+  );
+};

package/docs/vscode-extension.mdx

@@ -0,0 +1,74 @@
+---
+title: "VS Code Extension"
+description: "Connect your InsForge projects to AI coding assistants and install MCP with one click."
+---
+
+## Overview
+
+The InsForge VS Code extension:
+
+- Logs you in to InsForge (OAuth + PKCE)
+- Lets you pick an org/project
+- Installs InsForge MCP for your AI client
+
+It launches the MCP installer (`npx @insforge/install`) with your project’s API key and API base URL.
+
+## Links
+
+- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=InsForge.insforge)
+- [Open VSX](https://open-vsx.org/extension/InsForge/insforge)
+
+## Install
+
+1. Open VS Code
+2. Go to **Extensions**
+3. Search for **InsForge**
+4. Install the extension published by **insforge**
+
+## Use the extension
+
+<Steps>
+  <Step title="Open the InsForge panel">
+    Click the **InsForge** icon in the Activity Bar (left sidebar).
+  </Step>
+
+  <Step title="Login">
+    Click **Login with InsForge** and complete the login flow in your browser.
+
+    <Note>The callback is <code>http://127.0.0.1:54321/callback</code>.</Note>
+  </Step>
+
+  <Step title="Select a project">
+    Pick an organization and project from the InsForge tree view, or run <code>InsForge: Select Project</code> from the Command Palette.
+  </Step>
+
+  <Step title="Install MCP">
+    Run <code>InsForge: Install MCP</code> (or right-click a project and choose **Install MCP**), then pick the AI client you want to configure.
+
+    The installer runs in a VS Code terminal.
+  </Step>
+</Steps>
+
+## Supported AI clients
+
+The extension supports the following MCP “clients” (the value passed to `@insforge/install`):
+
+| Client | Typical config location |
+|---|---|
+| `cursor` | `~/.cursor/mcp.json` |
+| `claude-code` | `.mcp.json` in your workspace (project-local) |
+| `copilot` | `.vscode/mcp.json` in your workspace (project-local) |
+| `windsurf` | `~/.codeium/windsurf/` |
+| `cline` | Cline VS Code extension config |
+| `roocode` | Roo Code VS Code extension config |
+| `codex` | OpenAI Codex CLI config |
+| `trae` | Trae IDE config |
+| `qoder` | Qoder IDE config |
+
+If your client isn’t listed, run the installer manually (see <a href="/quickstart">Quickstart</a>).
+
+## Notes
+
+- **Project-local installs**: `claude-code` and `copilot` require an open workspace folder.
+- **Port in use**: free up `54321` and retry login.
+

package/eslint.config.js

@@ -319,6 +319,7 @@ export default defineConfig(
       'examples/**',
       'openapi/**',
       'functions/',
+      'backend/src/infra/database/migrations/bootstrap/**', // Bootstrap scripts run before build
     ],
   }
 );