Loading repository data…
amaan-ur-raheman / repository
AI-powered full-stack development environment for building web applications in your browser. Features intelligent code generation with multi-model AI support, live preview with WebContainer, integrated terminal, GitHub sync, and real-time collaboration. Built with Next.js 16, React 19, and Convex.
Clone the repository
git clone https://github.com/amaan-ur-raheman/polaris.git
cd polaris
Install dependencies
npm install
Set up environment variables
cp .env.example .env.local
Required environment variables:
# Convex
NEXT_PUBLIC_CONVEX_URL="your-convex-url"
CONVEX_DEPLOYMENT="your-deployment"
# Clerk Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY="your-clerk-key"
CLERK_SECRET_KEY="your-clerk-secret"
# AI Models (at least one required)
GROQ_API_KEY="your-groq-key"
OPENAI_API_KEY="your-openai-key"
# GitHub Integration
GITHUB_TOKEN="your-github-token"
# Inngest (for AI workflows)
INNGEST_EVENT_KEY="your-inngest-key"
INNGEST_SIGNING_KEY="your-signing-key"
# Firecrawl (optional)
FIRECRAWL_API_KEY="your-firecrawl-key"
Start the development server
npm run dev
The app will be available at http://localhost:3000
To run with Convex and Inngest for full functionality:
# Terminal 1: Start Next.js
npm run dev
# Terminal 2: Start Convex
npm run convex:dev
# Terminal 3: Start Inngest
npm run inngest:dev
# Or use mprocs to run all services
npm run dev:all
Example prompts:
Import from GitHub:
Export to GitHub:
polaris/
├── src/
│ ├── app/ # Next.js App Router
│ │ ├── api/ # API routes
│ │ └── projects/ # Project pages
│ ├── components/
│ │ ├── ui/ # shadcn/ui components
│ │ └── ai-elements/ # AI-specific components
│ ├── features/ # Feature-based modules
│ │ ├── auth/ # Authentication
│ │ ├── conversations/ # AI chat functionality
│ │ │ └── inngest/ # AI agent tools & workflows
│ │ ├── editor/ # Code editor
│ │ ├── preview/ # WebContainer preview
│ │ └── projects/ # Project management
│ ├── lib/ # Utilities and configs
│ ├── hooks/ # Custom React hooks
│ └── inngest/ # Inngest configuration
├── convex/ # Convex backend
│ ├── schema.ts # Database schema
│ ├── projects.ts # Project queries/mutations
│ ├── files.ts # File operations
│ └── conversations.ts # Chat history
└── public/ # Static assets
Polaris AI has access to the following tools for code generation:
| Tool | Description |
|---|---|
| listFiles | List all files and folders in the project |
| readFiles | Read content of specific files |
| createFiles | Create multiple files in batch |
| updateFile | Modify existing file content |
| deleteFiles | Remove files or folders |
| createFolder | Create new directories |
| renameFile | Rename files or folders |
| scrapeUrls | Fetch content from URLs for context |
Polaris uses WebContainer API which requires:
Contributions are welcome! Please feel free to submit a Pull Request.
git checkout -b feature/amazing-feature)git commit -m 'Add some amazing feature')git push origin feature/amazing-feature)This project is licensed under the MIT License - see the LICENSE file for details.
Selected from shared topics, language and repository description—not editorial ratings.
AnshikaAgarwal13 /
AI powered browser based code editor with intelligent coding assistance, real time editing, and interactive development workflows.