General
What is tinykit?
What is tinykit?
tinykit is an AI-powered development platform that lets you build, edit, and host web apps from a single deployment. Chat with AI to generate code, edit in a VS Code-like editor, and see changes live instantly.
How is this different from Lovable, v0, or Cursor?
How is this different from Lovable, v0, or Cursor?
The key difference: your builder and your app run on the same server.With other tools, you build locally then deploy separately. With tinykit, there’s no deploy step—your app is already live the moment you generate it.Plus: open source, bring your own AI key, works on mobile, multi-app support, and costs ~$10/month total.
Is this production-ready?
Is this production-ready?
tinykit is in early beta. Great for:
- Personal utilities and side projects
- Internal tools and admin dashboards
- MVPs and prototypes
- No guarantees against data loss—back up anything important
- Auth requires manual wiring (no built-in user auth for generated apps)
- Best suited for internal use or tools where you control access
Is it open source?
Is it open source?
Yes! MIT licensed. Fork it, customize it, self-host it, sell services with it. View on GitHub
Deployment & Hosting
Do I need Railway?
Do I need Railway?
No. Railway is the easiest option (one-click deploy), but you can host anywhere that runs Node.js:
- Fly.io
- DigitalOcean
- AWS
- Any VPS
- Docker
Can I run multiple apps?
Can I run multiple apps?
Yes! tinykit supports domain-based routing. Point multiple domains to your server and each serves a different app:Run hundreds of apps from a single tinykit instance.
Can I deploy the generated apps separately?
Can I deploy the generated apps separately?
For static apps (no database): Yes, export the built HTML and deploy anywhere.For apps using the database: No - these require tinykit’s backend APIs (
/_tk/data, /_tk/realtime). Keep them hosted on your tinykit instance, or use domain-based routing to serve multiple apps from one server.Can I use a custom domain?
Can I use a custom domain?
Yes. Configure your custom domain in Railway (or your hosting platform) and point your DNS there. tinykit automatically serves the right app based on the domain.
What about SSL/HTTPS?
What about SSL/HTTPS?
Railway and most modern platforms provide automatic HTTPS. No configuration needed.
AI & API Keys
Which AI providers are supported?
Which AI providers are supported?
- OpenAI - GPT-4o, GPT-4 Turbo, GPT-3.5
- Anthropic - Claude Sonnet 4, Claude 3.5 Sonnet
- Google Gemini - Gemini Pro, Gemini Flash
Why do I need my own API key?
Why do I need my own API key?
This keeps costs transparent and in your control. You pay your AI provider directly for what you use—no markup, no hidden fees, no subscription.
How much does AI usage cost?
How much does AI usage cost?
Typical casual usage: $3-5/month with GPT-4 or Claude.Heavy usage (building apps daily): $10-20/month.You can monitor and set limits in your provider’s dashboard.
Can I use Claude Pro or ChatGPT Plus instead of an API key?
Can I use Claude Pro or ChatGPT Plus instead of an API key?
Yes! If you already pay for Claude Pro, ChatGPT Plus, or another LLM subscription, you can generate apps in those interfaces and import them into tinykit.See No API Key Required for the snapshot format and prompt templates.
Builder Interface
What are the builder tabs?
What are the builder tabs?
| Tab | Purpose | Shortcut |
|---|---|---|
| Agent | Chat with AI to build your app | Cmd+1 |
| Code | Edit code directly | Cmd+2 |
| Content | CMS fields for non-developers | Cmd+3 |
| Design | CSS variables (colors, fonts, spacing) | Cmd+4 |
| Data | Browse and edit database records | Cmd+5 |
| History | Snapshots for undo/time travel | Cmd+6 |
What are Design fields?
What are Design fields?
Design fields are CSS variables that control your app’s appearance. The AI creates these as it builds, and non-technical users can customize them without code:
- Colors (primary, secondary, background)
- Fonts (family, sizes)
- Spacing (padding, margins)
- Borders (radius, shadows)
What are Content fields?
What are Content fields?
Content fields are CMS-like editable values—headlines, descriptions, button text. Perfect for letting clients update copy without accessing the code editor.
Does it work on mobile?
Does it work on mobile?
Yes! The editor and AI work on tablets. Perfect for quick edits on the go.
Features & Usage
What languages/frameworks does it generate?
What languages/frameworks does it generate?
tinykit generates Svelte 5 apps using the runes API (
$state, $derived, $effect). Apps compile to standalone HTML with CSS-in-style blocks.The AI is specifically tuned for this stack with detailed system prompts.Is there version control?
Is there version control?
Yes! Snapshots are built in. Every AI change creates a snapshot. Click any snapshot in the History tab to restore your code, design fields, and content to that point. Database records are not affected.
What about databases?
What about databases?
tinykit includes PocketBase—an embedded SQLite database with:
- Built-in authentication
- Real-time subscriptions
- Admin UI at
/_pb/_ - REST API
What templates are included?
What templates are included?
14 starter templates across categories:
| Category | Templates |
|---|---|
| Productivity | Kanban, Notes, Canvas, Timer |
| Finance | Expense tracker, Invoice generator |
| Content | Bookmarks, Recipes |
| Social | Linktree, Poll, Event RSVP |
| Business | Client CRM |
| News | HN reader, RSS reader |
Troubleshooting
The AI isn't responding
The AI isn't responding
Check:
- Your API key is correct in
.env - You have credits/quota with your AI provider
- The model name is correct (e.g.,
gpt-4o, notgpt4)
Preview isn't updating
Preview isn't updating
Try:
- Hard refresh the preview (Cmd+Shift+R)
- Check the browser console for errors
- Ensure files are saving (check for save indicator)
Files aren't saving
Files aren't saving
Check:
- File size is under 5MB
- File extension isn’t blocked (no .exe, .sh, etc.)
- Path doesn’t contain
../
Domain routing isn't working
Domain routing isn't working
Check:
- Your domain’s DNS is pointing to your tinykit server
- The domain is associated with a project in the dashboard
- SSL/HTTPS is properly configured
/tinykit/dashboard to see all projects and their domains.