- 
- 
- 
- 
- 
- 
+ 
+
+
-> [!CAUTION]
-> **v2 development in progress**
->
-> We're rearchitecting Fulling as an Agentic app. Breaking changes expected.
->
-> For stable, use [`v1.0.0`](https://github.com/FullAgent/fulling/tree/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
+Fulling is a product for creating ready-to-use AI workspaces.
+
+It is built around a practical problem: many professionals can benefit from AI,
+but they do not want to configure skills, prompts, memory, scripts, integrations,
+or runtime settings. Fulling gives creators a place to assemble those pieces,
+then share the finished workspace with the person who needs it.
+
+> [!NOTE]
+> Fulling v3.0 centers on workspace delivery: the setup work happens once, and
+> the recipient opens a prepared AI workspace instead of learning the AI stack.
+
+## Why Fulling?
+
+Most AI tools start with an empty chat box. That works for people who already
+know how to prompt, configure tools, and judge the outputs. It breaks down when
+the user is a domain expert who simply needs help with real work.
+
+Fulling turns that setup into a deliverable:
+
+- a building designer receives a workspace with drawing review workflows,
+ project references, and report templates
+- a consultant receives a workspace with client materials, analysis scripts,
+ and reusable delivery formats
+- a team receives a workspace with shared context, approved tools, and repeatable
+ operating routines
+
+The recipient uses the workspace. The creator owns the configuration.
+
+## Workspace Model
+
+An AI workspace combines the context, capabilities, and runtime needed for a
+specific person or job.
+
+| Part | Purpose |
+| --- | --- |
+| Mission | The job this AI workspace exists to help with |
+| Knowledge | Files, notes, examples, references, and domain material |
+| Memory | Durable context that can evolve over time |
+| Skills | Named capabilities the AI can use |
+| Scripts | Repeatable actions for work that needs reliability |
+| Runtime | A place where tools, code, and automation can run |
+| Sharing | A way to hand the configured workspace to another user |
+
+## How It Works
+
+```text
+Create
+ -> choose who the workspace is for
+ -> describe the work it supports
+ -> add knowledge and files
+ -> configure skills, scripts, memory, and runtime
+ -> test the workspace
+ -> share it with the recipient
+
+Use
+ -> open the prepared workspace
+ -> ask for work through task-focused entry points
+ -> review outputs, files, and approvals
+ -> keep using the same workspace as context grows
+```
-- **AI Pair Programmer** - Claude Code is pre-installed and ready. Describe what you want, it writes the code.
+## What Fulling Is Not
-- **Zero Setup** - Full-stack environment with database, terminal, and file manager. All pre-configured, ready in seconds.
+Fulling is not a prompt marketplace, generic chatbot builder, Kubernetes UI, or
+DevOps control panel. Those pieces can exist behind the scenes, but the product
+is organized around prepared AI workspaces.
-- **Web Terminal** - Full Linux terminal in your browser. Run commands, install packages, debug—everything you'd do locally.
+## Project Status
-- **File Manager** - Drag & drop files, edit code in browser. Large file support built-in.
+Fulling v3.0 is the active product direction. The current repository is being
+realigned around the workspace delivery model described above.
-- **Live Domains** - Your app gets HTTPS URLs instantly. No port forwarding, no ngrok. Just run and share.
+The previous v2.0.0 release is available at
+[Fulling v2.0.0](https://github.com/FullAgent/fulling/releases/tag/v2.0.0).
-- **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.
+Active branches:
-- **GitHub Integration** - Import repos, push changes, version control. Works like you'd expect.
+- `v3.0` for the current product direction
+- `release/2.0` for v2 maintenance
+- `main` is not the target branch for v3 work
-- **One-Click Deploy** - From sandbox to production in one click. No YAML, no CI/CD pipelines.
+## Tech Stack
-## Built With
+| Area | Stack |
+| --- | --- |
+| App | Next.js 16 App Router, React 19, TypeScript |
+| UI | Tailwind CSS v4, Shadcn/UI, Radix UI |
+| Data | Prisma, PostgreSQL |
+| Auth | NextAuth v5 |
+| Runtime | Kubernetes, KubeBlocks PostgreSQL, ttyd, FileBrowser |
+| Integrations | GitHub App, sandbox-side commands, AI proxy |
+| Testing | Vitest, ESLint |
-- **Frontend**: Next.js, React, TypeScript
-- **Backend**: Node.js, PostgreSQL
-- **Infrastructure**: Kubernetes
+## Repository Map
-For technical details, see [Architecture Documentation](./docs/architecture.md).
+```text
+app/ Next.js routes, dashboard, auth, API endpoints
+components/ Shared UI and layout components
+lib/ Application libraries and service code
+prisma/ Database schema and migrations
+runtime/ Runtime image and sandbox support files
+public/ Static icons and assets
+```
-## Installation
+## Local Development
### Prerequisites
-- Node.js 22.12.0 or higher
+- Node.js 22.12.0 or later
+- pnpm 10.20.0
- PostgreSQL database
- Kubernetes cluster with KubeBlocks installed
-- GitHub OAuth application credentials
+- GitHub App and OAuth credentials for GitHub integration work
-### Environment Setup
+### Setup
-1. Clone the repository:
```bash
git clone https://github.com/FullAgent/fulling.git
cd fulling
-```
-
-2. Install dependencies:
-```bash
pnpm install
-```
-
-3. Set up environment variables:
-
-Copy `.env.template` to `.env.local` and fill in your values:
-```bash
cp .env.template .env.local
-```
-
-4. Initialize database:
-```bash
npx prisma generate
npx prisma db push
+pnpm dev
```
-5. Run the development server:
-```bash
-pnpm run dev
-```
-
-Open [http://localhost:3000](http://localhost:3000) to access the application.
-
-### Database Schema
-
-See [Database Documentation](./docs/database.md) for schema details.
-
-## Deployment
-
-### Kubernetes Resources
-
-The platform creates the following Kubernetes resources for each project:
+Open [http://localhost:3000](http://localhost:3000).
-1. **Database Cluster** (KubeBlocks):
- - PostgreSQL 14.8.0
- - 3Gi storage
- - Auto-generated credentials
+## Useful Commands
-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
+```bash
+pnpm dev # Start the development server
+pnpm build # Generate Prisma client and build for production
+pnpm lint # Run ESLint
+pnpm test # Run Vitest
+pnpm test:watch # Run Vitest in watch mode
+npx prisma generate # Generate Prisma client
+npx prisma db push # Push schema changes to the database
```
-### 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](./docs/architecture.md) - Reconciliation pattern, event system
-- [Development Guide](./docs/development.md) - Local development
-- [Operations Manual](./docs/operations.md) - Deployment, monitoring
-- [Troubleshooting](./docs/troubleshooting.md) - 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](CONTRIBUTING.md) 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](LICENSE).
-
-See [CHANGELOG.md](CHANGELOG.md) for release history.
-
-## Acknowledgments
-
-- [Anthropic](https://www.anthropic.com/) for Claude Code
-- [Sealos](https://sealos.io/) for Kubernetes platform
-- [ttyd](https://github.com/tsl0922/ttyd) for web terminal
-- [FileBrowser](https://github.com/filebrowser/filebrowser) for file management
-
-## Contact
-
-- GitHub: [@fanux](https://github.com/fanux)
-- Issues: [GitHub Issues](https://github.com/FullAgent/fulling/issues)
-
-## Star us for latest updates
-
-
-
----
-
-
-
-
-
-
-
+
+
+ Package AI workspaces once. Share them with people who just need the AI to work.
+ +
+ 
+ Overview • + Workspace model • + How it works • + Project status • + Local development +
-100% AI-generated code. Prompted by [@fanux](https://github.com/fanux).
-
Powered by Claude Code, with models from Anthropic (Sonnet, Opus), Google (Gemini), Zhipu AI (GLM), and Moonshot (Kimi). -
+- [AGENTS.md](./AGENTS.md) - agent guidance for this repository
+- [docs/architecture.md](./docs/architecture.md) - v3 system architecture
diff --git a/app/(dashboard)/projects/(list)/_components/page-header-with-filter.tsx b/app/(dashboard)/projects/(list)/_components/page-header-with-filter.tsx
index 679aad9..37c781f 100644
--- a/app/(dashboard)/projects/(list)/_components/page-header-with-filter.tsx
+++ b/app/(dashboard)/projects/(list)/_components/page-header-with-filter.tsx
@@ -27,7 +27,7 @@ export function PageHeaderWithFilter({ activeFilter, onFilterChange }: PageHeade
My Projects
Powered by Claude Code, with models from Anthropic (Sonnet, Opus), Google (Gemini), Zhipu AI (GLM), and Moonshot (Kimi). -
- Manage and monitor your full stack apps and deployments. + Manage and monitor your full stack project workspaces.
- Connecting to GitHub allows you to sync your project to Fulling, and automatically deploys your production-ready project to Sealos. + Connecting to GitHub allows you to import repositories and keep project source metadata available in Fulling.
{installation ? ( diff --git a/app/(dashboard)/settings/_components/settings-sidebar.tsx b/app/(dashboard)/settings/_components/settings-sidebar.tsx index bb979b2..7015687 100644 --- a/app/(dashboard)/settings/_components/settings-sidebar.tsx +++ b/app/(dashboard)/settings/_components/settings-sidebar.tsx @@ -8,7 +8,6 @@ import { cn } from '@/lib/utils' const menuItems = [ { label: 'Integrations', href: '/settings/integrations' }, - { label: 'Account', href: '/settings/account' }, ] export function SettingsSidebar() { diff --git a/app/(landing)/_components/hero-section.tsx b/app/(landing)/_components/hero-section.tsx index 8d65239..d736bad 100644 --- a/app/(landing)/_components/hero-section.tsx +++ b/app/(landing)/_components/hero-section.tsx @@ -45,7 +45,7 @@ export function HeroSection({ {/* Subtitle */}Import an existing repo or start from scratch. Agents set up the workspace, runtime, - database, and deployment in the background. + optional database, and project automation in the background.
{/* Error message */} @@ -109,7 +109,7 @@ const FEATURES_JSX = (
- → Wiring runtime and deployment...
+ → Wiring runtime and project config...
@@ -61,7 +61,7 @@ export function TerminalDemo() {
@@ -73,7 +73,7 @@ export function TerminalDemo() {
(null);
-
- useEffect(() => {
- const canvas = canvasRef.current;
- if (!canvas) return;
-
- const ctx = canvas.getContext('2d');
- if (!ctx) return;
-
- let width = canvas.parentElement?.clientWidth || window.innerWidth;
- let height = canvas.parentElement?.clientHeight || window.innerHeight;
-
- // Set canvas size to match parent
- canvas.width = width;
- canvas.height = height;
-
- // Configuration
- const fontSize = 14;
- const columns = Math.ceil(width / fontSize);
- const drops: number[] = new Array(columns).fill(1);
-
- // VS Code-ish palette for the rain
- // Using a mix of green (comments), blue (keywords), and generic code colors
- const colors = ['#6a9955', '#dcdcaa'];
-
- // Characters: Katakana + Numbers + Operators + FULLING
- const chars = "ｱｲｳｴｵｶｷｸｹｺｻｼｽｾｿﾀﾁﾂﾃﾄﾅﾆﾇﾈﾉﾊﾋﾌﾍﾎﾏﾐﾑﾒﾓﾔﾕﾖﾗﾘﾙﾚﾛﾜﾝ1234567890<>{}[];:+-*/FULLING";
- const targetWord = "FULLING";
-
- // Track sequence progress for each column. -1 means no sequence active.
- const sequences: number[] = new Array(columns).fill(-1);
-
- const draw = () => {
- // Create fade effect
- // Use the VS Code background color (#1e1e1e) with high transparency
- ctx.fillStyle = 'rgba(30, 30, 30, 0.05)';
- ctx.shadowBlur = 0; // Reset shadow to prevent it affecting the background fade
- ctx.fillRect(0, 0, width, height);
-
- ctx.font = `${fontSize}px 'Consolas', 'Monaco', monospace`;
-
- for (let i = 0; i < drops.length; i++) {
- let text = '';
- let isTarget = false;
-
- // Logic for "FULLING" sequence
- if (sequences[i] >= 0) {
- // We are in a sequence
- text = targetWord[sequences[i]];
- isTarget = true;
- sequences[i]++;
- if (sequences[i] >= targetWord.length) {
- sequences[i] = -1; // Sequence complete
- }
- } else {
- // Random character
- text = chars[Math.floor(Math.random() * chars.length)];
-
- // Chance to start a sequence
- // Adjust probability as needed. 0.005 is 0.5% chance per frame per column.
- if (Math.random() < 0.005) {
- sequences[i] = 0;
- }
- }
-
- // Pick a random color from our palette to make it look like syntax highlighted code
- if (isTarget) {
- ctx.fillStyle = '#ffffff'; // Bright white for the target word
- ctx.shadowColor = '#ffffff';
- ctx.shadowBlur = 8;
- } else {
- ctx.fillStyle = colors[Math.floor(Math.random() * colors.length)];
- ctx.shadowBlur = 0;
- }
-
- // Draw the character
- ctx.fillText(text, i * fontSize, drops[i] * fontSize);
-
- // Reset drop to top randomly after it has crossed the screen
- // Randomness ensures drops don't fall in a perfect line
- if (drops[i] * fontSize > height && Math.random() > 0.975) {
- drops[i] = 0;
- sequences[i] = -1; // Reset sequence if drop resets
- }
-
- drops[i]++;
- }
- };
-
- const intervalId = setInterval(draw, 33); // ~30FPS
-
- const handleResize = () => {
- width = canvas.parentElement?.clientWidth || window.innerWidth;
- height = canvas.parentElement?.clientHeight || window.innerHeight;
- canvas.width = width;
- canvas.height = height;
-
- // Reset drops on resize to avoid gaps
- const newColumns = Math.ceil(width / fontSize);
- // Preserve existing drops if possible, or extend
- if (newColumns > drops.length) {
- const added = new Array(newColumns - drops.length).fill(1);
- drops.push(...added);
- }
- };
-
- window.addEventListener('resize', handleResize);
-
- return () => {
- clearInterval(intervalId);
- window.removeEventListener('resize', handleResize);
- };
- }, []);
-
- return (
-
- );
-};
\ No newline at end of file
diff --git a/components/home-page.tsx b/components/home-page.tsx
index b23f608..91e8bde 100644
--- a/components/home-page.tsx
+++ b/components/home-page.tsx
@@ -6,7 +6,6 @@ import Link from 'next/link';
import { useRouter } from 'next/navigation';
import { useSession } from 'next-auth/react';
-import { MatrixRain } from '@/components/MatrixRain';
import { Button } from '@/components/ui/button';
import { authenticateWithSealos } from '@/lib/actions/sealos-auth';
import { useSealos } from '@/provider/sealos';
@@ -85,9 +84,6 @@ export function HomePage() {
<>
{/* Base marketing page - always visible */}
- {/* Matrix Background Effect */}
-
{/* Hero Section: Logo and Title */}
diff --git a/components/sidebar.tsx b/components/sidebar.tsx
index e99d9bb..18691ae 100644
--- a/components/sidebar.tsx
+++ b/components/sidebar.tsx
@@ -2,10 +2,7 @@
import { FaGithub } from 'react-icons/fa6'
import {
- MdDashboardCustomize,
- MdExtension,
MdGridView,
- MdHub,
MdLightbulbOutline,
MdPsychology,
MdSettings,
@@ -15,17 +12,12 @@ import Link from 'next/link'
import { usePathname } from 'next/navigation'
import { Button } from '@/components/ui/button'
-import { Separator } from '@/components/ui/separator'
import packageInfo from '../package.json'
const menuItems = [
{ icon: MdGridView, label: 'Projects', href: '/projects', active: false },
{ icon: MdPsychology, label: 'Skills', href: '/skills', active: false },
- { icon: MdHub, label: 'MCP', href: '/mcp', active: false },
- { divider: true },
- { icon: MdDashboardCustomize, label: 'Templates', href: '/templates', active: false },
- { icon: MdExtension, label: 'Integrations', href: '/integrations', active: false },
{ icon: MdSettings, label: 'Settings', href: '/settings', active: false },
]
@@ -68,11 +60,7 @@ function NavMenu() {
return (