Skip to content

Poojan38380/Forge

Repository files navigation

Forge Logo

Forge

Your AI coding partner. In the browser. No setup needed.

Try Forge  



Forge IDE

What is Forge?

Imagine having a senior developer sitting right next to you — one who never gets tired, never judges your questions, and can write entire apps in seconds.

That's Forge.

You open the browser, describe what you want to build, and Forge's AI reads your files, writes code, and updates your project — all while you watch it happen in real time. No installations. No confusing terminals. Just you and your ideas.

When you're done, Forge runs your app live inside the browser — you can see it working immediately. And with one click, you can push it straight to GitHub.


A Quick Tour

1. Sign in & land on your dashboard

A beautiful split-screen landing page — showcase on the left, sign-in on the right. Works great on mobile too.

Forge home & auth page

Forge auth — mobile view


2. Start a new project — or import one from GitHub

Type what you want to build, or paste a GitHub link to bring in an existing project.

New project dialog   Import from GitHub

Import successful


3. Write code — or just ask Forge to write it for you

A full code editor on the left. A chat sidebar on the right. Ask Forge anything — it reads your files, makes the changes, and explains what it did.

Code editor


4. See your app running — live, in the browser

Switch to Preview mode. Forge installs dependencies and boots your app inside the browser. No terminal. No local server.

Preview mode


5. Never lose a conversation

Every AI chat is saved per project. Browse and pick up any past conversation right where you left off.

Past conversations


6. Power features at your fingertips

Quickly jump between all your projects with a command palette (Ctrl + K), export your work to a GitHub repo, or manage your plan — all without leaving the app.

Projects command palette   Export to GitHub

Billing via Clerk


How It All Works

flowchart LR
    A["💬 You type a message"] --> B["⚡ Forge AI reads your project files"]
    B --> C["✏️ AI writes / edits / creates files"]
    C --> D["💾 Changes saved instantly to the cloud"]
    D --> E["🌐 Live preview updates in the browser"]
    E --> F["🐙 Push to GitHub with one click"]
Loading

Forge runs the AI inside a background job (Inngest), so it never blocks the UI. Your editor stays fast while the AI does the heavy lifting.


✨ Features

Feature
🤖 AI coding assistant — Gemini 2.5 Flash reads, writes, creates, and deletes files
🌐 Live in-browser preview — your app runs inside the browser via WebContainers
📁 Full file explorer — create, rename, delete, and organize files and folders
💬 Persistent AI conversations — every chat is saved and searchable
🐙 GitHub import & export — clone any repo in, push any project out
Real-time sync — every change reflects instantly across tabs
🔐 Authentication & billing — secure sign-in and plan management via Clerk
📱 PWA ready — installable as an app on desktop and mobile

🛠️ Tech Stack

What it does Tool
Web framework Next.js 16
AI model Google Gemini 2.5 Flash
AI agent runner Inngest + Agent Kit
Real-time database Convex
In-browser runtime WebContainers
Authentication Clerk
Code editor CodeMirror 6
Web scraping (for AI context) Firecrawl
Error monitoring Sentry

🚀 Run It Yourself

Prerequisites

Steps

# 1. Clone the repo
git clone https://github.com/Poojan38380/Forge.git
cd forge

# 2. Install dependencies
npm install

# 3. Set up environment variables
cp env.example .env.local
# Fill in all the values — links to each service are in env.example

# 4. Start the app
npm run dev

Environment Variables

# Convex
NEXT_PUBLIC_CONVEX_URL=
CONVEX_DEPLOYMENT=
POLARIS_CONVEX_INTERNAL_KEY=

# Clerk
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=

# Google Gemini
GOOGLE_GENERATIVE_AI_API_KEY=

# Inngest
INNGEST_EVENT_KEY=
INNGEST_SIGNING_KEY=

# Firecrawl (optional — for AI web scraping)
FIRECRAWL_API_KEY=

📄 License

MIT — use it, learn from it, build on it.


Built by Poojan Goyani

About

AI-powered browser IDE built with Next.js 16, Gemini 2.5 Flash, Inngest Agent Kit, Convex, and WebContainers. Describe what you want → AI reads, writes & runs your code live in the browser.

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Languages