Instatic

Product Introduction

1. Definition: Instatic is an open-source, self-hosted, agentic visual Content Management System (CMS) and static site generator. It is a single-application platform that combines a visual design canvas, a content engine, a database, and a publishing system to output clean, static HTML, CSS, and JavaScript files.
2. Core Value Proposition: Instatic exists to provide developers, designers, and agencies with complete ownership and portability of their websites. It eliminates vendor lock-in by being MIT-licensed and self-hosted, while offering a modern, integrated visual development experience that rivals hosted platforms like Webflow and Framer, with the backend flexibility of WordPress.

Main Features

1. Unified Visual Canvas & Core Framework: The editor provides a true multi-breakpoint design canvas where changes reflect across all device views simultaneously. It natively integrates Core Framework, a professional design token engine, allowing for systematic control of colors, fluid typography scales, and spacing through CSS custom properties, which generate a minimal utility CSS framework.
2. Atomic Static Publishing: Unlike dynamic CMS platforms, pressing "publish" in Instatic triggers a build process that pre-renders every page to flat HTML files on disk. The live site directory is swapped atomically, ensuring visitors are served pre-built files with zero database queries or server-side rendering latency, and no risk of a partially published state.
3. Sandboxed Plugin Architecture (QuickJS-WASM): For extensibility, Instatic runs plugin server-side code in isolated, secure sandboxes. Each plugin operates in its own WebAssembly (WASM) worker using the QuickJS JavaScript interpreter, with no direct access to the host filesystem, Node/Bun APIs, or environment variables unless explicitly permitted via a manifest, preventing malicious or crashing plugins from affecting the core system.
4. Integrated AI Agent & MCP Server: The built-in AI agent can generate and edit page sections using semantic HTML styled with the site's existing design tokens. Furthermore, Instatic functions as a Model Context Protocol (MCP) server, allowing external AI tools (like Claude Code, Cursor) to securely connect and perform CMS operations via a standardized API, using scoped, revocable bearer tokens.
5. Intelligent Asset Pipeline & Responsive Images: Uploaded images are automatically processed into a ladder of WebP formats and BlurHash placeholders. Crucially, the static publisher analyzes the actual page layout (CSS Grid, Flexbox, container queries) to generate precise srcset and sizes HTML attributes, ensuring browsers download the optimally sized image file for the user's viewport.

Problems Solved

1. Pain Point: Vendor Lock-in and Platform Risk. Many visual builders and hosted CMS platforms trap user content and design within proprietary systems, making migration difficult and subject to unpredictable pricing or policy changes.
2. Target Audience: Frontend developers and technical designers seeking a visual workflow without sacrificing code ownership; digital agencies building client sites that must be portable and maintainable long-term; WordPress professionals frustrated with legacy code and plugin bloat, looking for a modern, integrated alternative.
3. Use Cases: An agency needs to build a high-performance, secure marketing site for a client and hand over the final static files for hosting on the client's preferred CDN. A developer wants to use a visual tool to prototype and build a personal blog but insists on owning the final output and hosting it on GitHub Pages. A team wants to use AI to assist in building page layouts but requires the output to be editable, clean code, not a locked screenshot.

Unique Advantages

1. Differentiation: Unlike Webflow or Framer, Instatic is self-hosted and outputs standard static files, granting full data ownership. Unlike traditional static site generators (e.g., Hugo, Jekyll), it provides a fully integrated, database-backed visual CMS with a real-time design canvas and user management, not just a file-based editor.
2. Key Innovation: The combination of a single Bun server process handling the admin, API, and publishing, coupled with an atomic file-swap publishing model and a secure QuickJS-WASM plugin sandbox. This architecture delivers the convenience of an all-in-one platform while maintaining the safety, performance, and portability of a static site.

Frequently Asked Questions (FAQ)

1. Is Instatic really a free and open-source alternative to Webflow? Yes, Instatic is MIT-licensed open-source software, meaning you can self-host it for free without subscription fees. It provides a visual canvas and CMS similar to Webflow but outputs static files you fully own, unlike Webflow's hosted, proprietary platform.
2. How does Instatic handle dynamic features like forms or search? Instatic includes a built-in form builder where form definitions, submissions, and data storage are handled within the CMS itself, eliminating third-party services. For highly dynamic features, its plugin system can add serverless functions that run in the secure sandbox, or you can use client-side JavaScript with the static API.
3. Can I migrate my existing WordPress or Webflow site to Instatic? Yes, Instatic features a "Super Import" tool that can convert a folder of static HTML/CSS or a site export into editable pages, design tokens, and classes. It intelligently maps styles to its token system and lets you resolve conflicts during the import process.
4. What are the hosting requirements for Instatic? Instatic requires a server (or PaaS like Railway) that can run a Bun server. It uses either SQLite (for simplicity) or PostgreSQL for the database. The static published files can then be served from the same server or copied to any static hosting service (Netlify, Vercel, S3, etc.).
5. How does the AI agent work, and do I need an API key? The built-in AI agent uses tools to read and modify your site's structure and content. You must provide your own API key for supported providers (OpenAI, Anthropic, OpenRouter, or local Ollama), giving you control over costs and model choice. The agent writes clean HTML that integrates with your design system.