Documentation

Introduction

Site Mills is an AI-first web development platform. Rather than dealing with fragmented toolchains, deployment pipelines, and environment setups, you converse with an orchestration agent that iteratively builds an application matching your intent.

We designed the system with constrained scope. By imposing strict, high-performance tech stacks (Preact + Tailwind + Backend TS in Isolates), the AI holds significantly deeper context, yielding robust, production-ready code faster than general AI coding tools.

How It Works

Building an app on Site Mills generally follows a simple loop:

1. Prompt: Go to the AI Studio and describe what you want (e.g., "Build a dashboard that tracks cryptocurrency prices").
2. Execution: The AI Agent orchestrates several specialized sub-agents. It outlines a plan, provisions a MongoDB schema, wires backend fetch routes for public APIs, constructs frontend UI components, and binds them together.
3. Preview & Verify: The platform instantly compiles your code and hot-reloads it in an isolated preview sandbox. The AI Verifier checks for syntax and runtime errors, patching them autonomously.
4. Manual Handoff: Jump into the integrated Code Editor any time to manually tweak logic, fix CSS, or add developer collaborators to your workspace.

Architecture Stack

• Frontend Core: Preact (React-compatible, highly performant) and Tailwind CSS for utility-first styling.
• Backend Runtime: TypeScript compiled natively and executed instantly inside heavily secured V8 Isolates.
• Data Layer: Globally dispersed MongoDB managed instances accessed through polyfilled SDKs.
• Orchestrator: Java/Spring Boot engine managing prompt strategy pipelines, multi-agent workflows, code history, and system rollbacks.

Preact & Tailwind CSS (Frontend)

Your frontend source code resides entirely in standard Component structures. The AI automatically structures your UI across generic `.jsx` or `.tsx` components and integrates Tailwind classes directly into standard semantic HTML.

Because there is no "build step" visible to you, changes made either via the AI Studio prompt or manually in the Code Editor are instantly reflected in your deployment envelope.

V8 Isolates Sandbox (Backend)

Traditional backend deployments are slow and costly. We built a custom V8 Isolate architecture (similar to edge functions) that natively parses your Typescript. When a user queries your backend endpoint, the Site Mills proxy engine dynamically spins up an isolate tailored exactly to your workspace context within 5ms.

For security, we strip native `Node.js` packages. Instead, we injected powerful polyfills that provide cleanly defined functionality without risk of underlying system escape.

Third-Party APIs & Integrations

Need to wire up Stripe, Twilio, OpenAI, or a specialized internal CRM? Simply ask the AI to map it. Because the frontend shouldn't hold secrets, the AI will build a backend Isolate typescript file that stores your API keys securely inside our platform's Vault, performs the outbound HTTP fetch, and proxies sanitized JSON down to your frontend.

Scheduled Jobs & Automation

Site Mills natively supports background automation without managing Linux Crons or Redis Queues. Through the dashboard or your AI Prompts, you can define asynchronous Jobs (e.g., Run billing compilation at 12:00 AM UTC daily). The runtime engine guarantees highly-available orchestration of these routines.

Document Database

All projects come with free-tier access to a managed Document DB (MongoDB). The AI utilizes a built-in polyfill db() wrapper in backend Isolates to instantly manage Schema-less structured data. Through the platform Dashboard, you can manually oversee rows, alter structure, query raw JSON, or purge caches.

Site Analytics & Insights

You don't need Google Analytics. The platform proxy records passive privacy-focused telemetry on edge requests. Access the Insights tab on your Dashboard to view global unique visits, API latency graphs, standard error rates across your specific isolates, and geographical distribution metrics—all visualized in real-time.

Collaboration & IDE

No more sending zip files or wrestling with Git conflicts. Site Mills workspaces can be shared with a simple URL.

• Invite Engineers: Coworkers get access to the professional monaco-based IDE built right into your dashboard.
• Simultaneous Editing: The AI can act as junior developer. Ask it to fix styling on the Header component while you manually write complex sorting algorithms in the backend Data controller.

Exporting Code

You are never locked in. If your scale exceeds Site Mills, or you desire traditional hosting platforms, you can instantly export your compiled application. The generated ZIP structure maps cleanly to a standard Monorepo layout ready for Vercel, Netlify, or standard Docker containment.