kivo

✨ Modern web development made simple - Launch beautiful projects in seconds.

Transform your ideas into stunning web experiences with minimal setup. Kivo combines the best modern tools into one seamless workflow.

🎯 Why Kivo?

Lightning Fast Setup ⚡
Zero configuration needed. Just run one command and start building.

Beautiful by Default 🎨
Vite-inspired design with dark mode, responsive layout, and modern typography.

Developer Experience 🔧
Hot reload, smart package detection, and optimized builds out of the box.

Production Ready 🚀
SEO-friendly, minified, and deployment-ready from day one.

🚀 Get Started

npx kivo my-project
cd my-project  
# kivo auto-detects your package manager (npm/yarn/pnpm)
{pm} run dev

That's it! Your project is live at http://localhost:8082

✨ What's Included

🎨 TailwindCSS - Utility-first styling
⚡ Eleventy - Fast static site generation
🌙 Dark Mode - System-aware theme switching
📱 Responsive Design - Mobile-first approach
🔧 Modern Tooling - PostCSS, Autoprefixer, minification
📦 Smart Detection - Auto-detects and uses npm, yarn, or pnpm

🏗️ Project Structure

my-project/
├── src/
│   ├── index.html          # Hero landing page
│   ├── _includes/base.html # Layout with navbar & footer
│   ├── styles/input.css    # TailwindCSS + dark mode
│   └── scripts/main.js     # Interactive features
├── config/                 # Build configuration
├── public/                 # Static assets
└── dist/                  # Production build

🎨 Design Philosophy

Minimal & Clean
Inspired by Vite's aesthetic - clean typography, subtle gradients, perfect spacing.

Dark Mode First
Respects system preferences, persistent user choice, smooth transitions.

Full-Screen Harmony
Perfect viewport fit without scrolling. Every pixel matters.

📝 Development Commands

# Your package manager (npm/yarn/pnpm) is auto-detected
{pm} run dev      # Start development with hot reload
{pm} run build    # Production build with optimization
{pm} run clean    # Clear build artifacts

🚀 Deploy Anywhere

Your project works everywhere:

Netlify → Drag & drop dist/
Vercel → Connect your Git repo
GitHub Pages → Enable in settings
Any CDN → Upload dist/ contents

🌟 Perfect For

• Landing pages
• Portfolio sites
• Documentation
• Prototypes
• Marketing sites
• Any modern web project

🔧 Requirements

• Node.js 18+
• Any package manager (auto-detected)

🎯 Built With Modern Standards

• ES Modules
• CSS Grid & Flexbox
• Semantic HTML5
• Web accessibility
• Performance optimized
• SEO ready

💡 Pro Tips

Instant Preview
Changes appear instantly with hot reload

Smart Package Manager
Automatically detects and uses your preferred package manager

Smart Defaults
Everything works without configuration

Extend Easily
Built on standard tools - customize anything

🤝 Contributing

Found a bug? Have an idea? Pull requests welcome!

📄 License

MIT © Uğur Toprakdeviren

🔗 Links

GitHub → toprakdeviren/kivo
npm → kivo

Launch beautiful web projects in seconds ✨