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?
Yes! Your apps compile to standalone HTML. Export and deploy anywhere:
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
- z.ai - GLM models
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.
Features & Usage
Does it work on mobile?
Does it work on mobile?
Yes! The editor and AI work great on tablets. Perfect for quick edits on the go.
Can I use my own code editor?
Can I use my own code editor?
The built-in Monaco editor is powerful, but you can also:
- Clone the workspace to your local machine
- Edit with VS Code, Cursor, or any editor
- Push changes back
What languages/frameworks are supported?
What languages/frameworks are supported?
tinykit generates Svelte apps by default, compiled to standalone HTML:
- Svelte 5 with runes
- Tailwind CSS
- PocketBase for data
Is there version control?
Is there version control?
Yes! Snapshots are built in. Every AI change creates a snapshot you can restore to. It’s like time travel for your app.
What about databases?
What about databases?
tinykit includes PocketBase—an embedded database. Create collections, store data, set up real-time subscriptions. The AI can wire up your data automatically.
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.