Fulling - AI-Powered Full-Stack Development Platform

What is Fulling?

Fulling lets you focus on coding. AI handles everything else.

Import your project from GitHub or start fresh. Claude Code is your AI pair programmer in a browser-based development environment with a terminal, file manager, live URLs, and optional PostgreSQL.

Configuration-aware development. Add project environment variables, secrets, auth keys, or payment keys in the UI. Claude Code can read that project context and use it while implementing features.

Overview

Fulling v2 provides a sandboxed development environment with Claude Code, GitHub import, optional PostgreSQL, and asynchronous background reconciliation for project resources.

Fulling automatically sets up the core workspace, ready in a minute: - AI pair programmer (Claude Code) - Full-stack development environment - Optional dedicated database (PostgreSQL) - Web terminal & file manager - Live HTTPS domains

Features

• AI Pair Programmer - Claude Code is pre-installed and ready. Describe what you want, it writes the code.

• Zero Setup Workspace - Full-stack environment with terminal, file manager, and live URLs. All pre-configured, ready in seconds.

• Web Terminal - Full Linux terminal in your browser. Run commands, install packages, debug—everything you'd do locally.

• File Manager - Drag & drop files, edit code in browser. Large file support built-in.

• Live Domains - Your app gets HTTPS URLs instantly. No port forwarding, no ngrok. Just run and share.

• Configuration-Aware - Add environment variables, secrets, auth keys, and payment keys in settings. Claude Code can read your config and implement against it.

• GitHub Integration - Import repos, push changes, version control. Works like you'd expect.

• Project Task Automation - GitHub import and skill installation run through persisted background tasks after the sandbox is ready.

Built With

• Frontend: Next.js, React, TypeScript
• Backend: Node.js, PostgreSQL
• Infrastructure: Kubernetes

For technical details, see Architecture Documentation.

Installation

Prerequisites

• Node.js 22.12.0 or higher
• PostgreSQL database
• Kubernetes cluster with KubeBlocks installed
• GitHub App and OAuth application credentials

Environment Setup

1. Clone the repository:

git clone https://github.com/FullAgent/fulling.git
cd fulling

1. Install dependencies:

pnpm install

1. Set up environment variables:

Copy .env.template to .env.local and fill in your values:

cp .env.template .env.local

1. Initialize database:

npx prisma generate
npx prisma db push

1. Run the development server:

pnpm run dev

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

Database Schema

See Database Documentation for schema details.

Deployment

Kubernetes Resources

The platform creates the following Kubernetes resources for each project:

1. Database Cluster (KubeBlocks):
2. PostgreSQL 14.8.0
3. 3Gi storage

4. Auto-generated credentials

5. Sandbox StatefulSet:

6. Custom fullstack-web-runtime image
7. Claude Code CLI pre-installed
8. ttyd web terminal (port 7681)
9. FileBrowser (port 8080)

10. Application port (3000)

11. Services & Ingresses:

12. Internal service for pod networking
13. HTTPS ingresses with SSL termination
14. WebSocket support for terminal

Resource Limits

Default resource allocation per sandbox: - CPU: 20m request, 2000m limit - Memory: 25Mi request, 4096Mi limit - Storage: 10Gi for sandbox, 3Gi for database

Development

Project Structure

fulling/
├── app/                    # Next.js App Router pages
│   ├── api/               # API routes
│   ├── projects/          # Project management pages
│   └── layout.tsx         # Root layout
├── components/            # React components
│   ├── ui/               # Shadcn/UI components
│   └── terminal/         # Terminal components
├── lib/                   # Core libraries
│   ├── k8s/              # Kubernetes managers
│   ├── events/           # Event system
│   ├── jobs/             # Background jobs
│   ├── repo/             # Repository layer
│   └── services/         # Business services
├── prisma/               # Database schema
├── runtime/              # Docker image for sandboxes
└── docs/                 # Documentation

Key Services

• SandboxManager (lib/k8s/sandbox-manager.ts) - StatefulSet operations
• DatabaseManager (lib/k8s/database-manager.ts) - KubeBlocks operations
• Authentication (lib/auth.ts) - Multi-provider OAuth
• Event Listeners (lib/events/) - Lifecycle handlers

Documentation

• Architecture - Reconciliation pattern, event system
• Development Guide - Local development
• Operations Manual - Deployment, monitoring
• Troubleshooting - Common issues
• v2.0.0 Release Notes - Release scope and migration notes

Security

• Authentication: Multi-provider OAuth (GitHub, Password, Sealos)
• Isolation: Each sandbox runs in user-specific Kubernetes namespace
• Terminal Auth: HTTP Basic Auth with URL token injection
• Secrets Management: Sensitive data stored in Kubernetes secrets
• Resource Limits: Prevents resource exhaustion

Contributing

See Contributing Guidelines for details.

Development Setup

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

License

MIT License - see LICENSE.

See v2.0.0 Release Notes for the current release scope.

Acknowledgments

• Anthropic for Claude Code
• Sealos for Kubernetes platform
• ttyd for web terminal
• FileBrowser for file management

Contact

• GitHub: @fanux
• Issues: GitHub Issues

Star us for latest updates

100% AI-generated code. Prompted by @fanux.

Powered by Claude Code, with models from Anthropic (Sonnet, Opus), Google (Gemini), Zhipu AI (GLM), and Moonshot (Kimi).