GIT-003 Addition: Create Repository from Editor

Insert this section into: dev-docs/tasks/phase-3-editor-ux-overhaul/TASK-002-github-integration/GIT-003-repository-cloning.md

Insert after: The existing "Repository Cloning" scope section

Additional Scope: Create Repository from Editor

Overview

Beyond cloning existing repositories, users should be able to create new GitHub repositories directly from the Nodegex launcher or editor without leaving the application.

Added Effort: 4-6 hours (on top of existing GIT-003 estimate)

User Flow

New Project Dialog:
├── 📁 Create Local Project (existing)
│       └── Standard local-only project
│
├── 📥 Clone from GitHub (existing GIT-003 scope)  
│       └── Clone existing repo
│
└── 🆕 Create New GitHub Repository (NEW)
        ├── Repository name: [my-noodl-project]
        ├── Description: [Optional description]
        ├── Visibility: ○ Public  ● Private
        ├── Owner: [▾ My Account / My Org 1 / My Org 2]
        ├── ☑ Initialize with README
        ├── ☑ Add .gitignore (Noodl template)
        └── [Create Repository & Open]

UI Design

┌─────────────────────────────────────────────────────────────────┐
│ Create New GitHub Repository                              [×]   │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│ OWNER                                                           │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ 👤 johndoe                                              [▾] │ │
│ │ ────────────────────────────────────────────────────────    │ │
│ │ 👤 johndoe (personal)                                       │ │
│ │ 🏢 my-company                                               │ │
│ │ 🏢 another-org                                              │ │
│ └─────────────────────────────────────────────────────────────┘ │
│                                                                 │
│ REPOSITORY NAME                                                 │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ my-awesome-app                                              │ │
│ └─────────────────────────────────────────────────────────────┘ │
│ ✓ my-awesome-app is available                                   │
│                                                                 │
│ DESCRIPTION (optional)                                          │
│ ┌─────────────────────────────────────────────────────────────┐ │
│ │ A Noodl project for...                                      │ │
│ └─────────────────────────────────────────────────────────────┘ │
│                                                                 │
│ VISIBILITY                                                      │
│ ● 🔓 Public - Anyone can see this repository                   │
│ ○ 🔒 Private - You choose who can see                          │
│                                                                 │
│ INITIALIZE                                                      │
│ ☑ Add README.md                                                │
│ ☑ Add .gitignore (Noodl template)                              │
│                                                                 │
│                              [Cancel]  [Create & Open Project]  │
└─────────────────────────────────────────────────────────────────┘

Technical Implementation

GitHub API Calls

// Create repository for user
POST /user/repos
{
  "name": "my-awesome-app",
  "description": "A Noodl project for...",
  "private": true,
  "auto_init": true  // Creates README
}

// Create repository for organization
POST /orgs/{org}/repos
{
  "name": "my-awesome-app",
  "description": "A Noodl project for...",
  "private": true,
  "auto_init": true
}

Required OAuth Scopes

Ensure GIT-001 OAuth requests these scopes:

repo - Full control of private repositories
read:org - Read organization membership (for org dropdown)

Name Validation

// Check if repo name is available
GET /repos/{owner}/{repo}
// 404 = available, 200 = taken

// Real-time validation as user types
const validateRepoName = async (owner: string, name: string): Promise<{
  available: boolean;
  suggestion?: string;  // If taken, suggest "name-2"
}> => {
  // Also validate:
  // - No spaces (replace with -)
  // - No special characters except - and _
  // - Max 100 characters
  // - Can't start with .
};

Files to Create

packages/noodl-editor/src/editor/src/views/Launcher/
├── CreateRepoDialog/
│   ├── CreateRepoDialog.tsx
│   ├── CreateRepoDialog.module.scss
│   ├── OwnerSelector.tsx        # Dropdown with user + orgs
│   ├── RepoNameInput.tsx        # With availability check
│   └── VisibilitySelector.tsx

Files to Modify

packages/noodl-editor/src/editor/src/views/Launcher/Launcher.tsx
  - Add "Create GitHub Repo" option to new project flow

packages/noodl-editor/src/editor/src/services/GitHubService.ts (from GIT-001)
  - Add createRepository() method
  - Add checkRepoNameAvailable() method
  - Add listUserOrganizations() method

Implementation Tasks

Owner Selection (1-2 hours)
- Fetch user's organizations from GitHub API
- Create dropdown component with user + orgs
- Handle orgs where user can't create repos
Repository Creation (2-3 hours)
- Implement name validation (real-time availability check)
- Create repository via API
- Handle visibility selection
- Initialize with README and .gitignore
Project Integration (1 hour)
- After creation, clone repo locally
- Initialize Noodl project in cloned directory
- Open project in editor

Success Criteria

User can create repo in their personal account
User can create repo in organizations they have access to
Name availability checked in real-time
Private/public selection works
Repo initialized with README and .gitignore
Project opens automatically after creation
Proper error handling (permission denied, name taken, etc.)

Updated GIT-003 Summary

Sub-Feature	Est. Hours	Priority
Clone existing repo	8-12	Critical
Create new repo	4-6	High
Private repo auth handling	2-3	High
Total	14-21	-

7.8 KiB Raw Permalink Blame History Unescape Escape