Files
autocoder/ui/src/components/NewProjectModal.tsx
Auto 41c1a14ae3 feat: add scaffold router and project template selection step
Add a new scaffold system that lets users choose a project template
(blank or agentic starter) during project creation. This inserts a
template selection step between folder selection and spec method choice.

Backend:
- New server/routers/scaffold.py with SSE streaming endpoint for
  running hardcoded scaffold commands (npx create-agentic-app)
- Path validation, security checks, and cross-platform npx resolution
- Registered scaffold_router in server/main.py and routers/__init__.py

Frontend (NewProjectModal.tsx):
- New "template" step with Blank Project and Agentic Starter cards
- Real-time scaffold output streaming with auto-scroll log viewer
- Success, error, and retry states with proper back-navigation
- Updated step flow: name → folder → template → method → chat/complete

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-26 13:18:55 +02:00

601 lines
21 KiB
TypeScript

/**
* New Project Modal Component
*
* Multi-step modal for creating new projects:
* 1. Enter project name
* 2. Select project folder
* 3. Choose project template (blank or agentic starter)
* 4. Choose spec method (Claude or manual)
* 5a. If Claude: Show SpecCreationChat
* 5b. If manual: Create project and close
*/
import { useRef, useState } from 'react'
import { createPortal } from 'react-dom'
import { Bot, FileEdit, ArrowRight, ArrowLeft, Loader2, CheckCircle2, Folder, Zap, FileCode2, AlertCircle, RotateCcw } from 'lucide-react'
import { useCreateProject } from '../hooks/useProjects'
import { SpecCreationChat } from './SpecCreationChat'
import { FolderBrowser } from './FolderBrowser'
import { startAgent } from '../lib/api'
import {
Dialog,
DialogContent,
DialogHeader,
DialogTitle,
DialogDescription,
DialogFooter,
} from '@/components/ui/dialog'
import { Button } from '@/components/ui/button'
import { Input } from '@/components/ui/input'
import { Label } from '@/components/ui/label'
import { Alert, AlertDescription } from '@/components/ui/alert'
import { Badge } from '@/components/ui/badge'
import { Card, CardContent } from '@/components/ui/card'
type InitializerStatus = 'idle' | 'starting' | 'error'
type ScaffoldStatus = 'idle' | 'running' | 'success' | 'error'
type Step = 'name' | 'folder' | 'template' | 'method' | 'chat' | 'complete'
type SpecMethod = 'claude' | 'manual'
interface NewProjectModalProps {
isOpen: boolean
onClose: () => void
onProjectCreated: (projectName: string) => void
onStepChange?: (step: Step) => void
}
export function NewProjectModal({
isOpen,
onClose,
onProjectCreated,
onStepChange,
}: NewProjectModalProps) {
const [step, setStep] = useState<Step>('name')
const [projectName, setProjectName] = useState('')
const [projectPath, setProjectPath] = useState<string | null>(null)
const [_specMethod, setSpecMethod] = useState<SpecMethod | null>(null)
const [error, setError] = useState<string | null>(null)
const [initializerStatus, setInitializerStatus] = useState<InitializerStatus>('idle')
const [initializerError, setInitializerError] = useState<string | null>(null)
const [yoloModeSelected, setYoloModeSelected] = useState(false)
const [scaffoldStatus, setScaffoldStatus] = useState<ScaffoldStatus>('idle')
const [scaffoldOutput, setScaffoldOutput] = useState<string[]>([])
const [scaffoldError, setScaffoldError] = useState<string | null>(null)
const scaffoldLogRef = useRef<HTMLDivElement>(null)
// Suppress unused variable warning - specMethod may be used in future
void _specMethod
const createProject = useCreateProject()
// Wrapper to notify parent of step changes
const changeStep = (newStep: Step) => {
setStep(newStep)
onStepChange?.(newStep)
}
if (!isOpen) return null
const handleNameSubmit = (e: React.FormEvent) => {
e.preventDefault()
const trimmed = projectName.trim()
if (!trimmed) {
setError('Please enter a project name')
return
}
if (!/^[a-zA-Z0-9_-]+$/.test(trimmed)) {
setError('Project name can only contain letters, numbers, hyphens, and underscores')
return
}
setError(null)
changeStep('folder')
}
const handleFolderSelect = (path: string) => {
setProjectPath(path)
changeStep('template')
}
const handleFolderCancel = () => {
changeStep('name')
}
const handleTemplateSelect = async (choice: 'blank' | 'agentic-starter') => {
if (choice === 'blank') {
changeStep('method')
return
}
if (!projectPath) return
setScaffoldStatus('running')
setScaffoldOutput([])
setScaffoldError(null)
try {
const res = await fetch('/api/scaffold/run', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({ template: 'agentic-starter', target_path: projectPath }),
})
if (!res.ok || !res.body) {
setScaffoldStatus('error')
setScaffoldError(`Server error: ${res.status}`)
return
}
const reader = res.body.getReader()
const decoder = new TextDecoder()
let buffer = ''
while (true) {
const { done, value } = await reader.read()
if (done) break
buffer += decoder.decode(value, { stream: true })
const lines = buffer.split('\n')
buffer = lines.pop() || ''
for (const line of lines) {
if (!line.startsWith('data: ')) continue
try {
const event = JSON.parse(line.slice(6))
if (event.type === 'output') {
setScaffoldOutput(prev => {
const next = [...prev, event.line]
return next.length > 100 ? next.slice(-100) : next
})
// Auto-scroll
setTimeout(() => scaffoldLogRef.current?.scrollTo(0, scaffoldLogRef.current.scrollHeight), 0)
} else if (event.type === 'complete') {
if (event.success) {
setScaffoldStatus('success')
setTimeout(() => changeStep('method'), 1200)
} else {
setScaffoldStatus('error')
setScaffoldError(`Scaffold exited with code ${event.exit_code}`)
}
} else if (event.type === 'error') {
setScaffoldStatus('error')
setScaffoldError(event.message)
}
} catch {
// skip malformed SSE lines
}
}
}
} catch (err) {
setScaffoldStatus('error')
setScaffoldError(err instanceof Error ? err.message : 'Failed to run scaffold')
}
}
const handleMethodSelect = async (method: SpecMethod) => {
setSpecMethod(method)
if (!projectPath) {
setError('Please select a project folder first')
changeStep('folder')
return
}
if (method === 'manual') {
// Create project immediately with manual method
try {
const project = await createProject.mutateAsync({
name: projectName.trim(),
path: projectPath,
specMethod: 'manual',
})
changeStep('complete')
setTimeout(() => {
onProjectCreated(project.name)
handleClose()
}, 1500)
} catch (err: unknown) {
setError(err instanceof Error ? err.message : 'Failed to create project')
}
} else {
// Create project then show chat
try {
await createProject.mutateAsync({
name: projectName.trim(),
path: projectPath,
specMethod: 'claude',
})
changeStep('chat')
} catch (err: unknown) {
setError(err instanceof Error ? err.message : 'Failed to create project')
}
}
}
const handleSpecComplete = async (_specPath: string, yoloMode: boolean = false) => {
// Save yoloMode for retry
setYoloModeSelected(yoloMode)
// Auto-start the initializer agent
setInitializerStatus('starting')
try {
// Use default concurrency of 3 to match AgentControl.tsx default
await startAgent(projectName.trim(), {
yoloMode,
maxConcurrency: 3,
})
// Success - navigate to project
changeStep('complete')
setTimeout(() => {
onProjectCreated(projectName.trim())
handleClose()
}, 1500)
} catch (err) {
setInitializerStatus('error')
setInitializerError(err instanceof Error ? err.message : 'Failed to start agent')
}
}
const handleRetryInitializer = () => {
setInitializerError(null)
setInitializerStatus('idle')
handleSpecComplete('', yoloModeSelected)
}
const handleChatCancel = () => {
// Go back to method selection but keep the project
changeStep('method')
setSpecMethod(null)
}
const handleExitToProject = () => {
// Exit chat and go directly to project - user can start agent manually
onProjectCreated(projectName.trim())
handleClose()
}
const handleClose = () => {
changeStep('name')
setProjectName('')
setProjectPath(null)
setSpecMethod(null)
setError(null)
setInitializerStatus('idle')
setInitializerError(null)
setYoloModeSelected(false)
setScaffoldStatus('idle')
setScaffoldOutput([])
setScaffoldError(null)
onClose()
}
const handleBack = () => {
if (step === 'method') {
changeStep('template')
setSpecMethod(null)
} else if (step === 'template') {
changeStep('folder')
setScaffoldStatus('idle')
setScaffoldOutput([])
setScaffoldError(null)
} else if (step === 'folder') {
changeStep('name')
setProjectPath(null)
}
}
// Full-screen chat view - use portal to render at body level
if (step === 'chat') {
return createPortal(
<div className="fixed inset-0 z-50 bg-background flex flex-col">
<SpecCreationChat
projectName={projectName.trim()}
onComplete={handleSpecComplete}
onCancel={handleChatCancel}
onExitToProject={handleExitToProject}
initializerStatus={initializerStatus}
initializerError={initializerError}
onRetryInitializer={handleRetryInitializer}
/>
</div>,
document.body
)
}
// Folder step uses larger modal
if (step === 'folder') {
return (
<Dialog open={true} onOpenChange={(open) => !open && handleClose()}>
<DialogContent className="sm:max-w-3xl max-h-[85vh] flex flex-col p-0">
{/* Header */}
<DialogHeader className="p-6 pb-4 border-b">
<div className="flex items-center gap-3">
<Folder size={24} className="text-primary" />
<div>
<DialogTitle>Select Project Location</DialogTitle>
<DialogDescription>
Select the folder to use for project <span className="font-semibold font-mono">{projectName}</span>. Create a new folder or choose an existing one.
</DialogDescription>
</div>
</div>
</DialogHeader>
{/* Folder Browser */}
<div className="flex-1 overflow-hidden">
<FolderBrowser
onSelect={handleFolderSelect}
onCancel={handleFolderCancel}
/>
</div>
</DialogContent>
</Dialog>
)
}
return (
<Dialog open={true} onOpenChange={(open) => !open && handleClose()}>
<DialogContent className="sm:max-w-lg">
<DialogHeader>
<DialogTitle>
{step === 'name' && 'Create New Project'}
{step === 'template' && 'Choose Project Template'}
{step === 'method' && 'Choose Setup Method'}
{step === 'complete' && 'Project Created!'}
</DialogTitle>
</DialogHeader>
{/* Step 1: Project Name */}
{step === 'name' && (
<form onSubmit={handleNameSubmit} className="space-y-4">
<div className="space-y-2">
<Label htmlFor="project-name">Project Name</Label>
<Input
id="project-name"
type="text"
value={projectName}
onChange={(e) => setProjectName(e.target.value)}
placeholder="my-awesome-app"
pattern="^[a-zA-Z0-9_-]+$"
autoFocus
/>
<p className="text-sm text-muted-foreground">
Use letters, numbers, hyphens, and underscores only.
</p>
</div>
{error && (
<Alert variant="destructive">
<AlertDescription>{error}</AlertDescription>
</Alert>
)}
<DialogFooter>
<Button type="submit" disabled={!projectName.trim()}>
Next
<ArrowRight size={16} />
</Button>
</DialogFooter>
</form>
)}
{/* Step 2: Project Template */}
{step === 'template' && (
<div className="space-y-4">
{scaffoldStatus === 'idle' && (
<>
<DialogDescription>
Start with a blank project or use a pre-configured template.
</DialogDescription>
<div className="space-y-3">
<Card
className="cursor-pointer hover:border-primary transition-colors"
onClick={() => handleTemplateSelect('blank')}
>
<CardContent className="p-4">
<div className="flex items-start gap-4">
<div className="p-2 bg-secondary rounded-lg">
<FileCode2 size={24} className="text-secondary-foreground" />
</div>
<div className="flex-1">
<span className="font-semibold">Blank Project</span>
<p className="text-sm text-muted-foreground mt-1">
Start from scratch. AutoForge will scaffold your app based on the spec you define.
</p>
</div>
</div>
</CardContent>
</Card>
<Card
className="cursor-pointer hover:border-primary transition-colors"
onClick={() => handleTemplateSelect('agentic-starter')}
>
<CardContent className="p-4">
<div className="flex items-start gap-4">
<div className="p-2 bg-primary/10 rounded-lg">
<Zap size={24} className="text-primary" />
</div>
<div className="flex-1">
<div className="flex items-center gap-2">
<span className="font-semibold">Agentic Starter</span>
<Badge variant="secondary">Next.js</Badge>
</div>
<p className="text-sm text-muted-foreground mt-1">
Pre-configured Next.js app with BetterAuth, Drizzle ORM, Postgres, and AI capabilities.
</p>
</div>
</div>
</CardContent>
</Card>
</div>
<DialogFooter className="sm:justify-start">
<Button variant="ghost" onClick={handleBack}>
<ArrowLeft size={16} />
Back
</Button>
</DialogFooter>
</>
)}
{scaffoldStatus === 'running' && (
<div className="space-y-3">
<div className="flex items-center gap-2">
<Loader2 size={16} className="animate-spin text-primary" />
<span className="font-medium">Setting up Agentic Starter...</span>
</div>
<div
ref={scaffoldLogRef}
className="bg-muted rounded-lg p-3 max-h-60 overflow-y-auto font-mono text-xs leading-relaxed"
>
{scaffoldOutput.map((line, i) => (
<div key={i} className="whitespace-pre-wrap break-all">{line}</div>
))}
</div>
</div>
)}
{scaffoldStatus === 'success' && (
<div className="text-center py-6">
<div className="inline-flex items-center justify-center w-12 h-12 bg-primary/10 rounded-full mb-3">
<CheckCircle2 size={24} className="text-primary" />
</div>
<p className="font-medium">Template ready!</p>
<p className="text-sm text-muted-foreground mt-1">Proceeding to setup method...</p>
</div>
)}
{scaffoldStatus === 'error' && (
<div className="space-y-3">
<Alert variant="destructive">
<AlertCircle size={16} />
<AlertDescription>
{scaffoldError || 'An unknown error occurred'}
</AlertDescription>
</Alert>
{scaffoldOutput.length > 0 && (
<div className="bg-muted rounded-lg p-3 max-h-40 overflow-y-auto font-mono text-xs leading-relaxed">
{scaffoldOutput.slice(-10).map((line, i) => (
<div key={i} className="whitespace-pre-wrap break-all">{line}</div>
))}
</div>
)}
<DialogFooter className="sm:justify-start gap-2">
<Button variant="ghost" onClick={handleBack}>
<ArrowLeft size={16} />
Back
</Button>
<Button variant="outline" onClick={() => handleTemplateSelect('agentic-starter')}>
<RotateCcw size={16} />
Retry
</Button>
</DialogFooter>
</div>
)}
</div>
)}
{/* Step 3: Spec Method */}
{step === 'method' && (
<div className="space-y-4">
<DialogDescription>
How would you like to define your project?
</DialogDescription>
<div className="space-y-3">
{/* Claude option */}
<Card
className="cursor-pointer hover:border-primary transition-colors"
onClick={() => !createProject.isPending && handleMethodSelect('claude')}
>
<CardContent className="p-4">
<div className="flex items-start gap-4">
<div className="p-2 bg-primary/10 rounded-lg">
<Bot size={24} className="text-primary" />
</div>
<div className="flex-1">
<div className="flex items-center gap-2">
<span className="font-semibold">Create with Claude</span>
<Badge>Recommended</Badge>
</div>
<p className="text-sm text-muted-foreground mt-1">
Interactive conversation to define features and generate your app specification automatically.
</p>
</div>
</div>
</CardContent>
</Card>
{/* Manual option */}
<Card
className="cursor-pointer hover:border-primary transition-colors"
onClick={() => !createProject.isPending && handleMethodSelect('manual')}
>
<CardContent className="p-4">
<div className="flex items-start gap-4">
<div className="p-2 bg-secondary rounded-lg">
<FileEdit size={24} className="text-secondary-foreground" />
</div>
<div className="flex-1">
<span className="font-semibold">Edit Templates Manually</span>
<p className="text-sm text-muted-foreground mt-1">
Edit the template files directly. Best for developers who want full control.
</p>
</div>
</div>
</CardContent>
</Card>
</div>
{error && (
<Alert variant="destructive">
<AlertDescription>{error}</AlertDescription>
</Alert>
)}
{createProject.isPending && (
<div className="flex items-center justify-center gap-2 text-muted-foreground">
<Loader2 size={16} className="animate-spin" />
<span>Creating project...</span>
</div>
)}
<DialogFooter className="sm:justify-start">
<Button
variant="ghost"
onClick={handleBack}
disabled={createProject.isPending}
>
<ArrowLeft size={16} />
Back
</Button>
</DialogFooter>
</div>
)}
{/* Step 3: Complete */}
{step === 'complete' && (
<div className="text-center py-8">
<div className="inline-flex items-center justify-center w-16 h-16 bg-primary/10 rounded-full mb-4">
<CheckCircle2 size={32} className="text-primary" />
</div>
<h3 className="font-semibold text-xl mb-2">{projectName}</h3>
<p className="text-muted-foreground">
Your project has been created successfully!
</p>
<div className="mt-4 flex items-center justify-center gap-2">
<Loader2 size={16} className="animate-spin" />
<span className="text-sm text-muted-foreground">Redirecting...</span>
</div>
</div>
)}
</DialogContent>
</Dialog>
)
}