insforge 0.3.3 → 1.3.0

package/docs/quickstart.mdx

@@ -0,0 +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>
+</Tabs>

package/docs/showcase.mdx

@@ -0,0 +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>

package/docs/snippets/sdk-installation.mdx

@@ -0,0 +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
+});
+```

package/docs/snippets/service-icons.mdx

@@ -0,0 +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>
+  );
+};

package/eslint.config.js

@@ -17,13 +17,20 @@ export default defineConfig(
   prettierConfig,
   // Frontend configuration
   {
-    files: ['frontend/**/*.ts', 'frontend/**/*.tsx'],
-    ignores: ['frontend/tests/**/*', 'frontend/**/*.test.*', 'frontend/**/*.spec.*'],
+    files: ['frontend/**/*.ts', 'frontend/**/*.tsx', 'auth/**/*.ts', 'auth/**/*.tsx'],
+    ignores: [
+      'frontend/tests/**/*',
+      'frontend/**/*.test.*',
+      'frontend/**/*.spec.*',
+      'auth/tests/**/*',
+      'auth/**/*.test.*',
+      'auth/**/*.spec.*',
+    ],
     languageOptions: {
       ecmaVersion: 'latest',
       sourceType: 'module',
       parserOptions: {
-        project: './frontend/tsconfig.json',
+        project: ['./frontend/tsconfig.json', './auth/tsconfig.json'],
         tsconfigRootDir: __dirname,
         ecmaFeatures: {
           jsx: true,