Repository files navigation

Fulling provides a sandboxed environment with Claude Code and PostgreSQL — everything you need to vibe code full-stack apps.

Fulling automatically sets up the following for your project, ready in a minute:

• Next.js environment with shadcn/ui
• Dedicated PostgreSQL (pre-configured)
• Claude Code (pre-configured)
• A live domain

Fulling is designed to streamline the entire full-stack development lifecycle using an AI-centric approach. Its core capabilities are delivered through a highly orchestrated, self-contained development sandbox:

• Pre-Configured AI Development Environment:

  • A complete, immediately usable development environment is provisioned, featuringNext.js,shadcn/ui, and theClaude Code CLI.
  • Essential AI-related environment variables (e.g.,BASE_URL,KEY, etc.) are automatically configured and injected, allowing the AI agent to begin coding instantly without manual setup.

• Isolated PostgreSQL Database Provisioning:

  • A dedicated and isolatedPostgreSQL database instance is automatically created for each project usingKubeBlocks.
  • The database connection string is securely injected into the development environment as an environment variable (DATABASE_URL), ensuring the AI can access and configure the persistence layer.

• Automated Public Endpoint and Domain Mapping:

  • Multiple accessible subdomains are automatically allocated and managed (HTTPS ingress with SSL termination).
  • These subdomains are configured to map to the specific application ports you wish to expose (e.g., ports 3000, 5000, 8080), providing immediate external access for testing and live development.

• Natural Language Interaction via Web Terminal:

  • All core development and configuration tasks are performed through a built-inWeb Terminal (ttyd) using natural language instructions.
  • This provides a direct, low-friction interface for interacting with the AI engineer, receiving code, running commands, and monitoring the development process.

• AI-Aware Business Configuration:

  • Specific business configurations, such asOAuth settings (e.g., GitHub authentication) andPayment configurations, can be fed into the platform.
  • This configuration metadata is made accessible as contextual prompts, allowing the Claude Code agent to intelligently perceive and implement corresponding features (e.g., configuring NextAuth) directly into the generated code.

• Seamless GitHub Repository Integration:

  • The platform is designed for easy association with an externalGitHub repository.
  • This facilitates standard code repository management, version control, and collaboration by connecting the AI's generated code to your preferred source control workflow.

• Automated High-Availability Deployment:

  • Projects can be automatically deployed from the development sandbox to a high-availability production environment, leveraging the underlyingKubernetes infrastructure.
  • This aims to abstract away the complexities of deployment, allowing the AI to manage the transition from development to live application.

• Framework: Next.js 15.5.4 (App Router)
• Language: TypeScript
• Styling: Tailwind CSS v4
• UI Components: Shadcn/UI
• State Management: React Hooks

• Runtime: Node.js
• API: Next.js API Routes
• Database ORM: Prisma
• Authentication: NextAuth v5 with GitHub OAuth

• Container Orchestration: Kubernetes
• Database: PostgreSQL (via KubeBlocks)
• Web Terminal: ttyd
• Container Image: fullstack-web-runtime (Custom Docker image with development tools)

• Node.js 20.x or higher
• PostgreSQL database
• Kubernetes cluster with KubeBlocks installed
• GitHub OAuth application credentials

1. Clone the repository:

git clone https://github.com/FullstackAgent/fulling.gitcd fulling

2. Install dependencies:

pnpm install

3. Set up environment variables:

Create.env.local file:

# DatabaseDATABASE_URL="postgresql://user:password@localhost:5432/fullstackagent"# NextAuthNEXTAUTH_URL="http://localhost:3000"NEXTAUTH_SECRET="your-nextauth-secret"AUTH_TRUST_HOST=""# GitHub OAuth (replace with your actual values)GITHUB_CLIENT_ID=""GITHUB_CLIENT_SECRET=""# Sealos OAuthSEALOS_JWT_SECRET=""# jobDATABASE_LOCK_DURATION_SECONDS=""MAX_DATABASES_PER_RECONCILE=""SANDBOX_LOCK_DURATION_SECONDS=""MAX_SANDBOXES_PER_RECONCILE=""# k8s resourceRUNTIME_IMAGE=""# aiproxyAIPROXY_ENDPOINT=""ANTHROPIC_BASE_URL=""# LogLOG_LEVEL="info"# loginENABLE_PASSWORD_AUTH=""ENABLE_PASSWORD_AUTH=""ENABLE_SEALOS_AUTH=""

6. Initialize database:

npx prisma generatenpx prisma db push

7. Run the development server:

pnpm run dev

Openhttp://localhost:3000 to access the application.

prisma/schema.prisma

The platform creates the following Kubernetes resources for each project:

1. Database Cluster (KubeBlocks):

   • PostgreSQL 14.8.0
   • 3Gi storage
   • Auto-generated credentials

2. Sandbox Deployment:

   • Custom fullstack-web-runtime image
   • Claude Code CLI pre-installed
   • Web terminal (ttyd) on port 7681
   • Application ports: 3000, 5000, 8080

3. Services & Ingress:

   • Internal service for pod networking
   • HTTPS ingress with SSL termination
   • WebSocket support for terminal

Default resource allocation per sandbox:

• CPU: 200m limit, 20m request
• Memory: 256Mi limit, 25Mi request
• Storage: 3Gi for database

fullstack-agent/├── app/                    # Next.js App Router pages│   ├── api/               # API routes│   ├── projects/          # Project management pages│   └── layout.tsx         # Root layout├── components/            # React components│   ├── ui/               # Shadcn/UI components│   └── ...               # Feature components├── lib/                   # Core libraries│   ├── auth.ts           # NextAuth configuration│   ├── db.ts             # Prisma client│   ├── kubernetes.ts     # Kubernetes service│   └── github.ts         # GitHub integration├── prisma/               # Database schema├── yaml/                 # Kubernetes templates└── public/               # Static assets

• Manages all Kubernetes operations
• Creates databases and sandboxes
• Handles pod lifecycle management

• GitHub OAuth integration
• Session management
• User authorization

• Prisma ORM configuration
• Connection pooling

POST /api/sandbox/[projectId]Content-Type: application/json{"envVars": {"KEY":"value"  }}

GET /api/sandbox/[projectId]

DELETE /api/sandbox/[projectId]

POST /api/projectsContent-Type: application/json{"name":"project-name","description":"Project description"}

• Authentication: GitHub OAuth ensures only authorized users can access the platform
• Isolation: Each sandbox runs in its own Kubernetes namespace
• Secrets Management: Sensitive data stored in Kubernetes secrets
• Network Policies: Sandboxes isolated from each other
• Resource Limits: Prevents resource exhaustion attacks

We welcome contributions! Please see ourContributing Guidelines for details.

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Run tests:npm test
5. Submit a pull request

This project is licensed under the MIT License - see theLICENSE file for details.

• Anthropic for Claude Code
• Sealos for Kubernetes platform
• ttyd for web terminal

• GitHub:@fanux
• Issues:GitHub Issues