Fulling - AI-Powered Full-Stack Development Platform

[!CAUTION] v2 development in progress

We're rearchitecting Fulling as an Agentic app. Breaking changes expected.

For stable, use v1.0.0.

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—it writes code, runs tests, manages databases, and deploys to production. All in a browser-based development environment.

Configuration-driven development. Need Stripe? OAuth? Just enter your API keys in project settings. Services become instantly available—no SDK setup, no environment variables, no integration code. Claude Code reads your config and implements the features for you.

Overview

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

Fulling automatically sets up everything you need, ready in a minute:

• AI pair programmer (Claude Code)
• Full-stack development environment
• 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 - Full-stack environment with database, terminal, and file manager. 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-Driven - Add Stripe, OAuth, or any service by entering API keys in settings. Claude Code reads your config and implements the integration for you.

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

• One-Click Deploy - From sandbox to production in one click. No YAML, no CI/CD pipelines.

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 OAuth application credentials

Environment Setup

1. Clone the repository:

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

2. Install dependencies:

pnpm install

3. Set up environment variables:

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

cp .env.template .env.local

4. Initialize database:

npx prisma generate
npx prisma db push

5. 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):

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

2. Sandbox StatefulSet:

   • Custom fullstack-web-runtime image
   • Claude Code CLI pre-installed
   • ttyd web terminal (port 7681)
   • FileBrowser (port 8080)
   • Application port (3000)

3. Services & Ingresses:

   • Internal service for pod networking
   • HTTPS ingresses with SSL termination
   • 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

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 CHANGELOG.md for release history.

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