Skip to content

pabl-o-ce/mio-startpage

Repository files navigation

Mio Startpage 🚀

A modern, customizable browser startpage built with SvelteKit 2, Svelte 5, and TailwindCSS. Features a clean interface with dark mode support, live clock, and search functionality.

✨ Features

  • 🎯 Clean, Minimal Interface: Modern and distraction-free design
  • 🌓 Dark/Light Mode: Automatic theme switching based on system preferences
  • Live Clock: Real-time clock and date display
  • 🔍 Quick Search: Instant search with keyboard shortcuts (press '/' to focus)
  • Fast & Responsive: Built with performance in mind
  • 📱 Mobile Friendly: Fully responsive design
  • 🛠️ Modern Tech Stack: Built with Svelte 5's latest features
  • 🚀 Cloudflare Pages: Optimized for deployment on Cloudflare Pages

🚀 Quick Start

Prerequisites

  • Node.js 18.x or later
  • pnpm 9.x or later

Installation

# Clone the repository
git clone https://github.com/pabl-o-ce/mio-startpage.git
cd mio-startpage

# Install dependencies
pnpm install

Development

# Start development server
pnpm dev

# Start with network access
pnpm dev --host

# Build for production
pnpm build

# Preview production build
pnpm preview

Cloudflare Pages Deployment

# Preview Cloudflare Pages deployment locally
pnpm pages:preview

# Deploy to Cloudflare Pages
pnpm pages:deploy

🛠️ Tech Stack

📦 Project Structure

mio-startpage/
├── src/
│   ├── components/     # Reusable components
│   ├── lib/           # Utility functions and shared code
│   ├── routes/        # SvelteKit routes
│   └── app.d.ts       # TypeScript declarations
├── static/            # Static assets
├── tests/            # Test files
└── [Configuration Files]

🧩 Features in Detail

Keyboard Shortcuts

  • / - Focus search bar
  • Esc - Clear search
  • More shortcuts coming soon!

Dark Mode

Dark mode automatically syncs with your system preferences but can be toggled manually. Your preference is saved in local storage.

🤝 Contributing

  1. Fork the repository
  2. Create a new branch: git checkout -b feature/amazing-feature
  3. Make your changes
  4. Commit: git commit -m 'feat: add amazing feature'
  5. Push: git push origin feature/amazing-feature
  6. Open a Pull Request

📝 License

MIT License

🙏 Acknowledgments


Made with ❤️ by PΛBLØ ᄃΞ