Zero Setup - Full-stack environment with database, terminal, and file manager. All pre-configured, ready in seconds.

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