Project Status: Beta - Ready for early adopters and contributors! Expect some rough edges, but core functionality is solid.
Remember the golden days of My Yahoo and iGoogle? Boxento is bringing that back - but better, open source, and completely in your control.
- Seasoned developers can dive deep into our codebase
- Hobby coders can modify existing widgets to suit their needs
- Complete beginners can use LLMs like ChatGPT, Claude, or LLM based code editors like Cursor or Windsurf to help generate widget code
There are no gatekeepers here - just bring your imagination, and we'll help you make it real. Check out our Widget Development Guide and Template Widget to get started.
- Why Boxento?
- What is Boxento?
- Installation
- Making Boxento Your Own
- Progressive Web App Support
- For Developers and Tinkerers
- Community & Support
- Roadmap
- License
While big tech has abandoned customizable start pages, we believe in:
- Your dashboard, your rules: Unlike closed platforms, you own and control everything
- Open source freedom: Modify, extend, or completely transform it to suit your needs
- Self-hosted privacy: Your data stays on your systems
- Creative expression: Build your perfect internet starting point, exactly how you want it
Boxento transforms your new tab or home page into a personalized command center with widgets that matter to you:
- ☑️ Track your to-dos and stay productive
- 🌤️ Check the weather without leaving your start page
- 🔗 Organize your favorite websites in one place
- 📝 Keep notes and ideas at your fingertips
- 🧩 Add more widgets or create your own!
All in a modern interface that gives you that warm, familiar feeling of the web's golden era.
Visit our live demo to try Boxento instantly.
Prerequisites:
- Bun (v1.0+)
- Git
git clone https://github.com/sushaantu/boxento.git
cd boxento
bun install
bun run devVisit http://localhost:5173 to see your personal dashboard.
We provide multiple ways to run Boxento using Docker, suitable for both development and production environments.
- Docker
- Docker Compose (optional)
# Pull and run
docker run -d -p 5173:5173 --name boxento ghcr.io/sushaantu/boxento:latestNeed to use a custom domain? Add the VITE_ALLOWED_HOSTS environment variable:
docker run -d -p 5173:5173 -e VITE_ALLOWED_HOSTS=your-domain.com --name boxento ghcr.io/sushaantu/boxento:latest# docker-compose.yml
services:
boxento:
image: ghcr.io/sushaantu/boxento:latest
container_name: boxento
restart: unless-stopped
ports:
- "5173:5173"
environment:
- NODE_ENV=production
- VITE_ALLOWED_HOSTS=your-domain.comdocker compose up -dBoxento supports two operating modes:
- No authentication required - Start using immediately
- All data stored locally in your browser's localStorage
- No external dependencies - Works completely offline
- Privacy focused - Your data never leaves your device
When running in local-only mode, you'll see "Local Mode" in the top-right corner instead of a login button.
- Firebase authentication - Secure login with Google, GitHub, email/password
- Cross-device sync - Access your dashboard from multiple devices
- Data backup - Your settings are stored in Firestore
- Requires setup - Need to configure Firebase environment variables
To enable cloud sync mode, set up Firebase environment variables:
VITE_FIREBASE_API_KEY=your-api-key
VITE_FIREBASE_AUTH_DOMAIN=your-project.firebaseapp.com
VITE_FIREBASE_PROJECT_ID=your-project-id
# ... other Firebase configNote: If you see "Firebase: Error (auth/api-key-not-valid)" - either run in local-only mode by removing all Firebase env vars, or set up valid Firebase credentials.
# Clone and setup
git clone https://github.com/sushaantu/boxento.git
cd boxento
# Start development container
docker compose up -d
# Stop when done
docker compose down# Setup environment
cp .env.example .env
# Edit .env with your configuration
# Build and start production
docker compose -f docker-compose.prod.yml up -dThe application automatically allows:
- localhost and 127.0.0.1
- *.docker.internal (Docker Desktop)
- *.orb.local (OrbStack)
- Custom domains via VITE_ALLOWED_HOSTS
To add custom domains:
VITE_ALLOWED_HOSTS=your-domain.com,another-domain.com docker compose up -dBoxento comes with a diverse collection of widgets organized by category:
- Todo Widget: Track tasks and stay organized
- Calendar Widget: Display upcoming events
- Notes Widget: Capture thoughts and ideas
- Pomodoro Timer: Boost productivity with time management
- GitHub Streak Tracker: Monitor your GitHub activity
- Weather Widget: Check current conditions and forecasts
- World Clocks Widget: Display time across different time zones
- RSS Feed Widget: Stay updated with favorite content
- Readwise Widget: Access your reading highlights
- Currency Converter: Live exchange rates
- UF (Chile) Widget: Display UF value in CLP
- Flight Tracker: Monitor real-time flight status
- YouTube Widget: Watch videos directly
- Geography Quiz: Test your knowledge
- Quick Links: Organize favorite websites
- Add Widgets: Click "+" to add widgets
- Arrange: Drag and drop anywhere
- Resize: Grab corners to resize
- Configure: Customize through settings
Anyone can create widgets - no matter your experience level:
- Check our resources:
- Fork the repo
- Use our guides with your favorite tools
- Share with the community or keep for personal use
- React
- Vite
- Tailwind CSS
- shadcn/ui
- Fork and clone the repo
- Create/update widgets in
/src/components/widgets/ - Test locally with
bun run dev - Submit a PR
Found a bug or have a feature request? Open an issue on our GitHub repository.
Boxento includes PWA support for:
- Install on device: Add to home screen
- Offline access: Use without internet
- Fast loading: Enhanced performance
See our PWA Support Guide for details.
Join our community:
- 🔒 End-to-End Encryption: Complete data privacy
- 🌐 Widget Marketplace: Community-created widgets
- 📱 Mobile Responsive Design: Perfect on any device
Want to influence what we build next? Join our Discord or open a feature request.
Boxento is open source under the MIT License - free to use, modify, and share.
