"Why can't building a website feel as fast as drafting a tweet?"
Prologue
A tired founder stares at a blank landing page and thinks: "Code, hosting, SEO, deployment—why so many moving parts?" That frustration sparked Vilcos.
Chapter 1 — Foundations
Vilcos unites three modern stacks:
- Chainlit + Agno – a model-agnostic AI co-developer that edits HTML/CSS/JS on demand.
- Vite + Tailwind – hot-reload frontend workflow for instant feedback.
- Docker + Fly.io – global deployment in a single command.
Workflow overview:
# Modern installation (new!)
npx create-vilcos-app my-website
# Standard operations
./vilcos start # Live AI editing & preview
./vilcos publish # Static build & SEO post-processing
./vilcos deploy # Multi-stage Docker → Fly.io edge
Get started in seconds with npx create-vilcos-app my-website and a polished black-themed template appears, ready for conversation-driven edits.
Chapter 2 — Conversational Development
Drag-and-drop builders limit creativity. Vilcos lets you talk to your site:
- Ask – "Add a pricing table with three tiers."
- See – Chainlit patches the code in seconds.
- Refine – "Switch to dark mode." Immediate.
An embedded knowledge base keeps the AI grounded in your exact template files, avoiding hallucinations and ensuring output matches your site's existing structure.
Chapter 3 — Deployment Without Drama
Docker compiles; Caddy serves; Fly.io distributes.
- Zero-config HTTPS and anycast IPs.
- Add a CNAME in Cloudflare, run
fly deploy, and you're online worldwide in under a minute.
Why It Matters
- Speed – Idea → live site in one sitting.
- Simplicity – One repo, one CLI, no CI pipeline gymnastics.
- Portability – Templates are plain files—take them anywhere.
- Flexibility – Works with any AI model that Agno supports.
- Accessibility – Install with a single command using the familiar npx pattern.
Join the project, open a chat with Vilcos, and build something remarkable.
Built with practical caffeine and a commitment to making the web faster to create.
Top comments (0)