insforge 0.3.3 → 1.2.10

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,128 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or
+  advances of any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email
+  address, without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official e-mail address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+tony.chang@insforge.dev.
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series
+of actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or
+permanent ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior,  harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within
+the community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 3.0, available at
+[https://www.contributor-covenant.org/version/3/0/code_of_conduct/](https://www.contributor-covenant.org/version/3/0/code_of_conduct/)
+
+Community Impact Guidelines were inspired by [Mozilla's code of conduct
+enforcement ladder](https://github.com/mozilla/diversity).
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see the FAQ at
+https://www.contributor-covenant.org/faq. Translations are available at
+https://www.contributor-covenant.org/translations.

package/CONTRIBUTING.md

@@ -23,7 +23,7 @@ The InsForge monorepo is organized as follows:
 - `/backend` - Core backend service with Express.js, PostgreSQL, and Better Auth integration
 - `/frontend` - React-based admin dashboard for managing databases, users, and storage
 - `/shared-schemas` - Zod schemas and TypeScript types shared between frontend and backend
-- `/docs` - MCP documemtation
+- `/docs` - MCP documentation
 - `/functions` - Serverless edge functions for custom business logic
 - `docker-compose.yml` - Docker config file to start the project
 

package/Dockerfile

@@ -6,6 +6,7 @@ WORKDIR /app
 COPY package.json ./
 COPY backend/package.json ./backend/
 COPY frontend/package.json ./frontend/
+COPY auth/package.json ./auth/
 COPY shared-schemas/package.json ./shared-schemas/
 
 # Install all dependencies - will generate Linux-compatible lock file
@@ -15,9 +16,11 @@ RUN npm install && npm cache clean --force && rm -rf /tmp/*
 COPY . .
 
 # Build arguments for Vite environment variables
+# These must be defined as ARG because Vite replaces import.meta.env.VITE_* at build time
 ARG VITE_API_BASE_URL
+ARG VITE_PUBLIC_POSTHOG_KEY
 
-# Build frontend with the API URL baked in
+# Build frontend and auth app with environment variables baked in
 RUN npm run build
 
 # Expose ports

package/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-  <a href="https://insforge.com">
+  <a href="https://insforge.dev">
     <img src="assets/banner.png" alt="Insforge Logo">
   </a>
   
@@ -7,30 +7,30 @@
 <p align="center">
    <a href="#quickstart-tldr">Get Started</a> · 
    <a href="https://docs.insforge.dev/introduction">Documentation</a> · 
-   <a href="https://discord.gg/MPxwj5xVvW">Discord</a>
+   <a href="https://discord.com/invite/MPxwj5xVvW">Discord</a>
 </p>
 <p align="center">
    <a href="https://opensource.org/licenses/Apache-2.0"><img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License"></a>
-   <a href="https://discord.gg/MPxwj5xVvW"><img src="https://img.shields.io/badge/Discord-Join%20Community-7289DA?logo=discord&logoColor=white" alt="Discord"></a>
+   <a href="https://discord.com/invite/MPxwj5xVvW"><img src="https://img.shields.io/badge/Discord-Join%20Community-7289DA?logo=discord&logoColor=white" alt="Discord"></a>
    <a href="https://github.com/InsForge/insforge/stargazers"><img src="https://img.shields.io/github/stars/InsForge/insforge?style=social" alt="GitHub Stars"></a>
 </p>
 
 # InsForge
 
-**InsForge is the Agent-Native Supabase Alternative.** We are building the features of Supabase in an AI-native way, enabling AI agents to build and manage full-stack applications autonomously. 
-
+**InsForge is the backend built for AI-assisted development.**
+Connect InsForge with any agent. Add authentication, database, storage, functions, and AI integrations to your app in seconds.
 ## Key Features & Use Cases
 
 ### Core Features:
 - **Authentication** - Complete user management system
 - **Database** - Flexible data storage and retrieval
 - **Storage** - File management and organization
+- **AI Integration** - Chat completions and image generation (OpenAI-compatible)
 - **Serverless Functions** - Scalable compute power
 - **Site Deployment** *(coming soon)* - Easy application deployment
 
 ### Use Cases: Building full-stack applications using natural language
 - **Connect AI agents to InsForge** - Enable Claude, GPT, or other AI agents to manage your backend
-- **Add backend to Lovable or Bolt-style vibe coding project projects** - Instant backend for AI-generated frontends
 
 ## Prompt Examples:
 
@@ -67,7 +67,7 @@ Visit InsForge Dashboard (default: http://localhost:7131), log in, and follow th
         <em>Sign in to InsForge</em>
       </td>
       <td align="center">
-        <img src="assets/mcpInstallv2.png" alt="MCP Configuration"">
+        <img src="assets/mcpInstallv2.png" alt="MCP Configuration">
         <br>
         <em>Configure MCP connection</em>
       </td>
@@ -79,7 +79,7 @@ Visit InsForge Dashboard (default: http://localhost:7131), log in, and follow th
 
 In your agent, send:
 ```
-InsForge is my backend platform, what is my current backend structure?
+I'm using InsForge as my backend platform, fetch InsForge instruction doc to learn more about InsForge.
 ```
 
 <div align="center">
@@ -92,17 +92,53 @@ InsForge is my backend platform, what is my current backend structure?
 
 Start building your project in a new directory! Build your next todo app, Instagram clone, or online platform in seconds!
 
-**Sample Project Prompts:**
-- "Build a todo app with user authentication"
-- "Create an Instagram with image upload"
+**Sample Project Prompt:**
 
-## Architecture
+"Build an app similar to Reddit with community-based discussion threads using InsForge as the backend platform that has these features:
+- Has a "Communities" list where users can browse or create communities
+- Each community has its own posts feed
+- Users can create posts with a title and body (text or image upload to InsForge storage)
+- Users can comment on posts and reply to other comments
+- Allows upvoting and downvoting for both posts and comments
+- Shows vote counts and comment counts for each post"
 
+## Architecture
 
-<div align="center">
-  <img src="assets/archDiagram.png" alt="Carch">
-  <br>
-</div>
+```mermaid
+graph TD
+    subgraph agents[" "]
+        A1[Claude]
+        A2[Cursor]
+        A3[Windsurf]
+        A4[Coding Agent]
+    end
+
+    A1 --> MCP[Model Context Protocol]
+    A2 --> MCP
+    A3 --> MCP
+    A4 --> MCP
+
+    MCP -->|fetch-docs| INS[InsForge Instructions]
+
+    MCP -->|create-bucket| S[Storage]
+    MCP --> AUTH[Auth]
+    MCP -->|run-raw-sql| DB[Database]
+    MCP -->|create-function| EF[Edge Function]
+    MCP --> AI[AI Integration]
+
+    style agents fill:#1a1a1a,stroke:#666,color:#fff
+    style MCP fill:#000,stroke:#666,color:#fff
+    style INS fill:#4a5568,stroke:#666,color:#fff
+    style S fill:#4a5568,stroke:#666,color:#fff
+    style AUTH fill:#4a5568,stroke:#666,color:#fff
+    style DB fill:#4a5568,stroke:#666,color:#fff
+    style EF fill:#4a5568,stroke:#666,color:#fff
+    style AI fill:#4a5568,stroke:#666,color:#fff
+    style A1 fill:#4a5568,stroke:#666,color:#fff
+    style A2 fill:#4a5568,stroke:#666,color:#fff
+    style A3 fill:#4a5568,stroke:#666,color:#fff
+    style A4 fill:#4a5568,stroke:#666,color:#fff
+```
 
 
 
@@ -110,7 +146,7 @@ Start building your project in a new directory! Build your next todo app, Instag
 
 **Contributing**: If you're interested in contributing, you can check our guide here [CONTRIBUTING.md](CONTRIBUTING.md). We truly appreciate pull requests, all types of help are appreciated!
 
-**Support**: If you need any type of help support, we're responsive on our [Discord channel](https://discord.gg/MPxwj5xVvW), and also feel free to email us [info@insforge.dev](mailto:info@insforge.dev) too!
+**Support**: If you need any help or support, we're responsive on our [Discord channel](https://discord.com/invite/MPxwj5xVvW), and also feel free to email us [info@insforge.dev](mailto:info@insforge.dev) too!
 
 
 ## Documentation & Support
@@ -119,7 +155,7 @@ Start building your project in a new directory! Build your next todo app, Instag
 - **[Official Docs](https://docs.insforge.dev/introduction)** - Comprehensive guides and API references
 
 ### Community
-- **[Discord](https://discord.gg/D3Vf8zD2ZS)** - Join our vibrant community
+- **[Discord](https://discord.com/invite/MPxwj5xVvW)** - Join our vibrant community
 - **[Twitter](https://x.com/InsForge_dev)** - Follow for updates and tips
 
 ### Contact
@@ -132,3 +168,15 @@ This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENS
 ---
 
 [![Star History Chart](https://api.star-history.com/svg?repos=InsForge/insforge&type=Date)](https://www.star-history.com/#InsForge/insforge&Date)
+
+## Translations
+
+- [Arabic | العربية](/i18n/README.ar.md)
+- [Spanish | Español](/i18n/README.es.md)
+- [French | Français](/i18n/README.fr.md)
+- [Hindi | हिंदी](/i18n/README.hi.md)
+- [Japanese | 日本語](/i18n/README.ja.md)
+- [Korean | 한국어](/i18n/README.ko.md)
+- [Portuguese (Brazilian) / Português Brasileiro](/i18n/README.pt-BR.md)
+- [Russian | Русский](/i18n/README.ru.md)
+- [Chinese (Simplified) | 简体中文](/i18n/README.zh-CN.md)

package/auth/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <link rel="icon" type="image/x-icon" href="/favicon.ico" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>InsForge Authentication</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/auth/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "insforge-auth",
+  "version": "1.0.0",
+  "author": "Insforge",
+  "description": "Built-in authentication UI for Insforge users",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "@insforge/react": "^1.0.0",
+    "@insforge/shared-schemas": "^1.1.23",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0",
+    "react-router-dom": "^7.7.0"
+  },
+  "devDependencies": {
+    "@tailwindcss/vite": "^4.1.11",
+    "@types/react": "^19.2.2",
+    "@types/react-dom": "^19.2.2",
+    "@vitejs/plugin-react": "^4.7.0",
+    "tailwindcss": "^4.1.11",
+    "tailwindcss-animate": "^1.0.7",
+    "vite": "^7.0.5"
+  }
+}

package/auth/src/App.tsx

@@ -0,0 +1,33 @@
+import { Routes, Route, Navigate } from 'react-router-dom';
+import { SignInPage } from './pages/SignInPage';
+import { SignUpPage } from './pages/SignUpPage';
+import { VerifyEmailPage } from './pages/VerifyEmailPage';
+import { ForgotPasswordPage } from './pages/ForgotPasswordPage';
+import { ResetPasswordPage } from './pages/ResetPasswordPage';
+import { Layout } from './components/Layout';
+
+export enum AuthRouterPath {
+  SIGN_IN = '/auth/sign-in',
+  SIGN_UP = '/auth/sign-up',
+  VERIFY_EMAIL = '/auth/verify-email',
+  FORGOT_PASSWORD = '/auth/forgot-password',
+  RESET_PASSWORD = '/auth/reset-password',
+}
+
+export function App() {
+  return (
+    <Layout>
+      <Routes>
+        {/* Main routes */}
+        <Route path={AuthRouterPath.SIGN_IN} element={<SignInPage />} />
+        <Route path={AuthRouterPath.SIGN_UP} element={<SignUpPage />} />
+        <Route path={AuthRouterPath.VERIFY_EMAIL} element={<VerifyEmailPage />} />
+        <Route path={AuthRouterPath.FORGOT_PASSWORD} element={<ForgotPasswordPage />} />
+        <Route path={AuthRouterPath.RESET_PASSWORD} element={<ResetPasswordPage />} />
+        <Route path="*" element={<Navigate to={AuthRouterPath.SIGN_IN} replace />} />
+      </Routes>
+    </Layout>
+  );
+}
+
+export default App;

package/auth/src/components/ErrorCard.tsx

@@ -0,0 +1,37 @@
+import { ReactNode } from 'react';
+
+interface ErrorCardProps {
+  title?: string;
+  children: ReactNode;
+}
+
+export function ErrorCard({ title = 'Error', children }: ErrorCardProps) {
+  return (
+    <div className="w-full max-w-md mx-auto">
+      <div className="bg-white dark:bg-neutral-800 rounded-lg shadow-lg border border-red-200 dark:border-red-800 p-6">
+        <div className="flex items-start">
+          <div className="flex-shrink-0">
+            <svg
+              className="h-6 w-6 text-red-600 dark:text-red-400"
+              fill="none"
+              viewBox="0 0 24 24"
+              strokeWidth="2"
+              stroke="currentColor"
+              aria-hidden="true"
+            >
+              <path
+                strokeLinecap="round"
+                strokeLinejoin="round"
+                d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"
+              />
+            </svg>
+          </div>
+          <div className="ml-3 flex-1">
+            <h3 className="text-sm font-medium text-red-800 dark:text-red-200">{title}</h3>
+            <div className="mt-2 text-sm text-red-700 dark:text-red-300">{children}</div>
+          </div>
+        </div>
+      </div>
+    </div>
+  );
+}

package/auth/src/components/Layout.tsx

@@ -0,0 +1,13 @@
+import { ReactNode } from 'react';
+
+interface LayoutProps {
+  children: ReactNode;
+}
+
+export function Layout({ children }: LayoutProps) {
+  return (
+    <div className="min-h-screen flex items-center justify-center bg-linear-to-br from-gray-50 to-gray-100 dark:from-neutral-900 dark:to-neutral-800">
+      {children}
+    </div>
+  );
+}

package/auth/src/index.css

@@ -0,0 +1,19 @@
+@import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap');
+@import 'tailwindcss';
+
+@layer base {
+  :root {
+    /* Font system */
+    --fontFamilyBase:
+      'Inter', system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+    --fontFamilyManrope: 'Manrope', sans-serif;
+  }
+
+  body {
+    font-family: var(--fontFamilyBase);
+  }
+
+  button {
+    cursor: pointer;
+  }
+}

package/auth/src/lib/broadcastService.ts

@@ -0,0 +1,115 @@
+export enum BroadcastEventType {
+  EMAIL_VERIFIED_SUCCESS = 'EMAIL_VERIFIED_SUCCESS',
+  PASSWORD_RESET_SUCCESS = 'PASSWORD_RESET_SUCCESS',
+}
+
+export interface BroadcastEvent {
+  type: BroadcastEventType;
+  timestamp: number;
+  data?: {
+    accessToken?: string;
+    user?: { id: string; email: string; name: string };
+  };
+}
+
+export type BroadcastEventHandler = (event: BroadcastEvent) => void;
+
+class BroadcastService {
+  private channel: BroadcastChannel | null = null;
+  private readonly CHANNEL_NAME = 'insforge-auth-channel';
+  private handlers: Map<BroadcastEventType, Set<BroadcastEventHandler>> = new Map();
+  private isInitialized = false;
+
+  private isSupported(): boolean {
+    return typeof window !== 'undefined' && 'BroadcastChannel' in window;
+  }
+
+  init(): void {
+    if (this.isInitialized) {
+      return;
+    }
+
+    if (!this.isSupported()) {
+      console.warn('BroadcastChannel API is not supported in this browser');
+      return;
+    }
+
+    try {
+      this.channel = new BroadcastChannel(this.CHANNEL_NAME);
+      this.channel.onmessage = (messageEvent: MessageEvent<BroadcastEvent>) => {
+        const event = messageEvent.data;
+        this.handleIncomingEvent(event);
+      };
+      this.isInitialized = true;
+    } catch (error) {
+      console.error('Failed to initialize BroadcastService:', error);
+    }
+  }
+
+  private handleIncomingEvent(event: BroadcastEvent): void {
+    const handlers = this.handlers.get(event.type);
+    if (handlers) {
+      handlers.forEach((handler) => {
+        try {
+          handler(event);
+        } catch (error) {
+          console.error('Error handling broadcast event:', error);
+        }
+      });
+    }
+  }
+
+  subscribe(eventType: BroadcastEventType, handler: BroadcastEventHandler): () => void {
+    if (!this.isInitialized) {
+      this.init();
+    }
+
+    if (!this.handlers.has(eventType)) {
+      this.handlers.set(eventType, new Set());
+    }
+
+    this.handlers.get(eventType)?.add(handler);
+
+    return () => {
+      const handlers = this.handlers.get(eventType);
+      if (handlers) {
+        handlers.delete(handler);
+      }
+    };
+  }
+
+  broadcast(eventType: BroadcastEventType, data?: BroadcastEvent['data']): void {
+    if (!this.isInitialized) {
+      this.init();
+    }
+
+    if (!this.channel) {
+      console.warn('BroadcastChannel not available, cannot broadcast event');
+      return;
+    }
+
+    const event: BroadcastEvent = {
+      type: eventType,
+      timestamp: Date.now(),
+      data,
+    };
+
+    try {
+      this.channel.postMessage(event);
+    } catch (error) {
+      console.error('Failed to broadcast event:', error);
+    }
+  }
+
+  close(): void {
+    if (this.channel) {
+      this.channel.close();
+      this.channel = null;
+    }
+    this.handlers.clear();
+    this.isInitialized = false;
+  }
+}
+
+const broadcastService = new BroadcastService();
+export default broadcastService;

package/auth/src/lib/utils.ts

@@ -0,0 +1,11 @@
+import { type ClassValue, clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}
+
+export const getBackendUrl = () => {
+  const isHttp = window.location.protocol === 'http:';
+  return isHttp ? 'http://localhost:7130' : window.location.origin;
+};

package/auth/src/main.tsx

@@ -0,0 +1,22 @@
+import { StrictMode } from 'react';
+import { createRoot } from 'react-dom/client';
+import { BrowserRouter } from 'react-router-dom';
+import { InsforgeProvider } from '@insforge/react';
+import './index.css';
+import App from './App';
+import { getBackendUrl } from './lib/utils';
+
+const backendUrl = getBackendUrl();
+
+const rootElement = document.getElementById('root');
+if (rootElement) {
+  createRoot(rootElement).render(
+    <StrictMode>
+      <BrowserRouter>
+        <InsforgeProvider baseUrl={backendUrl}>
+          <App />
+        </InsforgeProvider>
+      </BrowserRouter>
+    </StrictMode>
+  );
+}

package/auth/src/pages/ForgotPasswordPage.tsx

@@ -0,0 +1,11 @@
+import { ForgotPassword } from '@insforge/react';
+
+export function ForgotPasswordPage() {
+  return (
+    <ForgotPassword
+      onError={(error) => {
+        console.error('Failed to send reset code:', error);
+      }}
+    />
+  );
+}

package/auth/src/pages/ResetPasswordPage.tsx

@@ -0,0 +1,11 @@
+import { ResetPassword } from '@insforge/react';
+
+export function ResetPasswordPage() {
+  return (
+    <ResetPassword
+      onError={(error) => {
+        console.error('Failed to reset password:', error);
+      }}
+    />
+  );
+}