Skip to content

Lostovayne/Complete-Cursor-Clone-Next16

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Polaris

AI-powered, real-time code editor built for professional workflows.

Next.js React TypeScript Convex CodeMirror Claude

Polaris is a full-featured, AI-powered real-time code editor built from the ground up. It delivers a professional developer experience with a CodeMirror 6 editor (syntax highlighting, code folding, minimap), AI-powered code suggestions and quick edits using Claude, and background job execution for AI agents.

Built on Next.js 16, Convex for real-time data, and modern performance-first architecture.


✨ Highlights

  • Real-time collaboration with low-latency updates powered by Convex.
  • Pro-grade editor: CodeMirror 6 with syntax highlighting, folding, minimap, and extensible plugins.
  • AI assistance: Claude-backed suggestions, quick edits, and background agent jobs.
  • Performance-focused: streaming UI, edge-friendly design, and optimized rendering paths.
  • Modern stack: Next.js App Router, TypeScript, Tailwind UI components, and scalable architecture.

🧭 Product Overview

Polaris is designed as a professional DE that feels instant and intelligent. The editor is the core, but the platform layers in AI workflows, real-time collaboration, and job orchestration to support serious developer use cases.

Core Capabilities

  • Editor UX: custom commands, rich keyboard workflow, and multi-pane layout.
  • AI workflows: contextual suggestions, rewrite/quick edit, and agent-driven tasks.
  • Real-time data: presence, collaborative updates, and low-latency syncing.
  • Scalable architecture: background jobs and asynchronous workflows for agent execution.

🧩 Architecture

flowchart LR
	User((Developer)) --> UI[Next.js 16 App Router]
	UI --> CM[CodeMirror 6 Editor]
	UI --> AI[Claude AI Services]
	UI --> Convex[Convex Realtime Backend]
	Convex --> DB[(Convex Storage)]
	AI --> Jobs[Background Job Runner]
	Jobs --> Convex
Loading

Data & Collaboration Flow

sequenceDiagram
	participant U as User
	participant UI as Next.js UI
	participant C as Convex Realtime
	participant A as AI Agent

	U->>UI: Edit code
	UI->>C: Publish change
	C-->>UI: Broadcast updates
	UI->>A: Request AI suggestion
	A-->>UI: Return patch
Loading

⚙️ Tech Stack

Tech icons

  • Frontend: Next.js 16 (App Router), React, TypeScript
  • Editor: CodeMirror 6
  • Realtime: Convex
  • UI: Tailwind CSS + component library
  • AI: Claude for suggestions and quick edits
  • Infra: Modern performance-first patterns, background jobs

🚀 Getting Started

Prerequisites

  • Node.js 24+ (recomendado)
  • pnpm v11 (recomendado) — también funcionan npm, yarn o bun, pero este repo usa pnpm por consistencia
  • Convex account + deployed project

Installation

git clone <your-repo-url>
cd cursor-clone

Instala dependencias con pnpm (recomendado):

pnpm install

Environment Variables

Copia .env.example a .env.local y rellena las variables necesarias (Convex + AI keys). Ejemplo mínimo:

CONVEX_DEPLOYMENT=
NEXT_PUBLIC_CONVEX_URL=
CLAUDE_API_KEY=

Run the App

Usa pnpm para iniciar el entorno de desarrollo:

pnpm dev

Open http://localhost:3000 to view the application.


🧪 Quality & Performance

  • Real-time latency budget optimized via Convex subscriptions.
  • Streaming UI for large documents and AI responses.
  • Background jobs for non-blocking AI agent work.
  • Typed end-to-end for reliability in real-time workflows.

📁 Project Structure (High Level)

  • app/ – Next.js App Router pages and layouts
  • components/ – UI components and shared building blocks
  • convex/ – Realtime functions, schema, and backend logic
  • hooks/ – Client hooks and runtime helpers
  • lib/ – Utilities and shared helpers

🧑‍💻 Contributing

We welcome contributions from developers who want to enhance the experience of Polaris.

  1. Fork the repo
  2. Create a feature branch
  3. Commit changes with clear messages
  4. Open a pull request

📜 License

This project is licensed under the MIT License.


🔒 Security

If you discover a security issue, please report it privately and responsibly.


📬 Contact

For business or partnership inquiries, open an issue or contact the maintainer.

About

Polaris, a full-featured AI-powered code editor built from the ground up. Professional DE with a CodeMirror 6 editor that includes syntax highlighting, code folding, and a minimap, integrating AI-powered code suggestions and quick edit features using Claude, managing background job execution for AI agents.

Topics

Resources

Stars

Watchers

Forks

Contributors