Startlight
✦ A Luminous Digital Portal ✦
"Where every new tab becomes a gateway to serenity,
Crafted with Svelte, kissed by Catppuccin's beauty."
🎨 Catppuccin Flavours ✦ Glassmorphism Aesthetics ✦ Weather Integration ✦ Svelte Performance
🌟 Gallery
Experience the sublime beauty of each Catppuccin flavour
✨ Features
🎯 Core Capabilities
| Feature | Description |
|---|---|
| 🎨 Catppuccin Themes | Four exquisite flavours: Latte, Frappé, Macchiato, Mocha |
| 🌌 Dynamic Backgrounds | Customizable imagery that breathes life into your portal |
| 🧊 Glassmorphism | Modern frosted glass aesthetics with elegant blur effects |
| 🌤️ Weather Oracle | Real-time weather integration via OpenWeatherMap API |
| ⏰ Temporal Awareness | Localized time and date display with elegant typography |
| 🔗 Quick Navigation | Personalized quick links for instant access to your digital realm |
| ⚙️ Intuitive Settings | Minimal configuration panel revealed through hover interaction |
| 💨 Svelte Performance | Lightning-fast rendering with minimal resource footprint |
| 🌐 Compatibility | Works seamlessly with Brave, Chrome & Firefox |
📦 Installation
Prerequisites
Install the Cascadia Code font family on your system for optimal typography.
Browser Installation
🦊 Firefox Installation
Download the latest version
Go to releases and download the .xpi file
- Navigate to about:addons in Firefox
- Click the gear icon → "Install Add-on From File..."
- Select the .xpi file from the repo
🌐 Chrome / Brave Installation
# Clone or download the repository
git clone https://github.com/OrynVail/Startlight.git
cd Startlight
# Navigate to chrome://extensions/ or brave://extensions/
# Enable "Developer Mode"
# Click "Load unpacked" → select the /public/ folder
🛠️ Customization
⚙️ Settings Panel
Hover in the bottom right corner to reveal the ethereal settings panel:
| Setting | Description |
|---|---|
| 👤 Personalization | Set your preferred name for a personal touch |
| 🌤️ Weather Configuration | Add your OpenWeatherMap API key for weather integration |
| 🖼️ Background Artistry | Upload or select custom background imagery |
| 🎨 Flavour Selection | Choose between Latte, Frappé, Macchiato, or Mocha themes |
| 🔗 Quick Links | Customize your frequently accessed portals |
🎨 Theme Flavours
| Flavour | Vibe | Best For |
|---|---|---|
| ☀️ Latte | Light & Airy | Daytime productivity |
| 🌅 Frappé | Warm Twilight | Evening sessions |
| 🌙 Macchiato | Cool Midnight | Night owls |
| 🌑 Mocha | Deep Darkness | True dark mode lovers |
🔧 Development
Local Development
# Clone the repository
git clone https://github.com/oryn-ai/startlight.git
cd startlight
# Install dependencies
npm install
# Start development server
npm run dev
# Build for production
npm run build
🤝 Contributing
Contributions to enhance this digital portal are warmly welcomed!
Ways to Contribute
- 🐛 Report bugs or visual inconsistencies
- 💡 Suggest new features or integrations
- 🎨 Propose new Catppuccin theme implementations
- 📝 Improve documentation
🙏 Acknowledgments
- refact0r - For the foundational code and design
- Catppuccin - For the sublime color palettes that inspire tranquility
- Svelte - For the elegant framework that makes magic possible
- OpenWeatherMap - For bringing weather awareness to your portal
📜 License
This project is licensed under the MIT License - see the LICENSE file for details.
