Skip to content
BranchesTags

Latest commit

 

History

35 Commits

Folders and files

NameName
Last commit message
Last commit date
.vscode
.vscode
 
 
css
css
 
 
js
js
 
 
scratch
scratch
 
 
tests
tests
 
 
.gitignore
.gitignore
 
 
CODE_REVIEW_AUDIT.md
CODE_REVIEW_AUDIT.md
 
 
CODE_REVIEW_MAIN_BRANCH.md
CODE_REVIEW_MAIN_BRANCH.md
 
 
DailyCosmos_Technical_Roadmap.docx
DailyCosmos_Technical_Roadmap.docx
 
 
HARSHIT_SHARMA_Premium_browser_startpage_logo_embodying_'privacy-first_customiza_14bf08ef-06f2-4883-860e-2f001e0e92b5.png
HARSHIT_SHARMA_Premium_browser_startpage_logo_embodying_'privacy-first_customiza_14bf08ef-06f2-4883-860e-2f001e0e92b5.png
 
 
LICENSE
LICENSE
 
 
Logo.png
Logo.png
 
 
README.md
README.md
 
 
SESSION_CHECKPOINT.md
SESSION_CHECKPOINT.md
 
 
apple-touch-icon.png
apple-touch-icon.png
 
 
favicon-96x96.png
favicon-96x96.png
 
 
favicon.ico
favicon.ico
 
 
favicon.svg
favicon.svg
 
 
index.html
index.html
 
 
package-lock.json
package-lock.json
 
 
package.json
package.json
 
 
pr_diff.txt
pr_diff.txt
 
 
server.js
server.js
 
 
site.webmanifest
site.webmanifest
 
 
web-app-manifest-192x192.png
web-app-manifest-192x192.png
 
 
web-app-manifest-512x512.png
web-app-manifest-512x512.png
 
 

Repository files navigation

🌟 Customizable Browser Startpage

A beautiful, secure, and highly customizable browser homepage replacement with 13 premium themes, privacy controls, and zero dependencies.

Version License Security Privacy

✨ Features

🎨 13 Premium Themes

  • Dark Slate (default) | Light | Ocean
  • 🌃 Cyberpunk (particle effects)
  • 🌅 Sunset | 🌲 Forest
  • ✨ Aurora Wave (animated gradients)
  • 🌌 Northern Lights (animated)
  • 🌙 Midnight | 🌹 Rose Gold
  • Custom theme builder with accent colors

🔒 Security & Privacy

  • ✅ Content Security Policy (CSP) headers
  • ✅ XSS protection with input sanitization
  • ✅ URL validation (HTTP/HTTPS only)
  • ✅ API rate limiting (10 calls/min)
  • ✅ Secure favicon loading
  • ✅ Privacy panel with data controls
  • ✅ No tracking, no cookies, no external analytics
  • ✅ All data stored locally in browser

🔖 Smart Bookmarks

  • Add/Edit/Delete bookmarks with favicons
  • Drag & drop reordering
  • Search and filter
  • Right-click context menu
  • XSS-safe rendering
  • Export/Import settings

🔍 Multi-Engine Search

  • Google | Bing | DuckDuckGo | Yahoo | Brave
  • Quick engine switcher
  • Search from main page

💻 GitHub Integration

  • Display profile information
  • Repository stats (repos, followers, gists)
  • Most starred repositories
  • Clean, modern UI

💬 Inspirational Quotes

  • Random quotes from Quotable API
  • Auto-refresh feature
  • Fallback quotes included

🕐 Clock & Greetings

  • Live updating clock
  • 12/24 hour format toggle
  • Time-based greetings (Good morning/afternoon/evening)
  • Full date display

🖼️ Background Customization

  • Upload custom images
  • Unsplash integration
  • Gradient backgrounds
  • Blur effects
  • Persistent settings

⚙️ Settings Management

  • Export all settings (JSON)
  • Import settings from backup
  • Reset to defaults
  • Cloud-free backup/restore

🚀 Quick Start

Option 1: Use Directly

  1. Download or clone this repository
  2. Open index.html in your browser
  3. Set as your browser homepage

Option 2: GitHub Pages (Live Demo)

Visit the live demo: https://[YourUsername].github.io/Customizable-Browser-Startpage/

Set as Homepage

Chrome/Edge:

  1. Settings → Appearance → Show home button
  2. Enter path to index.html or GitHub Pages URL

Firefox:

  1. Settings → Home → Homepage and new windows
  2. Enter path to index.html or GitHub Pages URL

🛡️ Security Features

This startpage is built with security as a top priority:

Feature Implementation
CSP Headers Blocks inline scripts and XSS attacks
Input Sanitization All user inputs are escaped and validated
URL Validation Only HTTP/HTTPS protocols allowed
API Security Rate limiting, timeouts, no credentials
Privacy First No external tracking or data collection
Safe Storage All data in browser localStorage only

🎨 Themes Preview

Choose from 13 carefully designed themes:

  • Dark Slate: Professional dark theme (default)
  • Cyberpunk: Neon colors with particle effects
  • Aurora Wave: Animated blue-to-violet gradients
  • Northern Lights: Dynamic aurora animations
  • Sunset: Warm orange/pink gradients
  • Forest: Calming green nature theme
  • And 7 more!

📦 What's Included

Customizable-Browser-Startpage/
├── index.html           # Main HTML with CSP headers
├── js/
│   ├── main.js         # Core functionality (947 lines)
│   └── privacy.js      # Privacy controls (70 lines)
├── css/
│   └── style.css       # All styles including themes (1,160 lines)
└── README.md           # This file

Total: ~2,400 lines of clean, well-commented code
Dependencies: None (pure vanilla JavaScript)

🔧 Configuration

GitHub Widget

Edit line ~950 in js/main.js:

const GITHUB_USERNAME = 'YourUsername';

Default Theme

Edit line 26 in index.html:

<body data-theme="slate">

API Rate Limits

Edit js/main.js rate limit settings:

const rateLimitWindow = 60000; // 1 minute
const maxRequests = 10;        // Max 10 calls

🎯 Keyboard Shortcuts

  • N - Add new bookmark
  • B - Background settings
  • T - Theme selector
  • ESC - Close modals/panels

🧪 Browser Compatibility

✅ Tested and working:

  • Chrome/Edge (v90+)
  • Firefox (v88+)
  • Safari (v14+)
  • Brave
  • Opera

📋 Roadmap

Implemented ✅

  • 13 premium themes
  • Security hardening (CSP, XSS protection)
  • Privacy panel and controls
  • Bookmark management
  • GitHub widget
  • Multi-engine search
  • Export/Import settings

Future Enhancements 🔜

  • Todo widget
  • Auto theme (time-based light/dark)
  • Timezone widget
  • Widget collapse/expand
  • Bookmark folders/tags
  • Weather widget

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Quotable API - Random quotes
  • GitHub API - Profile data
  • Google Fonts - Inter font family
  • Unsplash - Optional background images

📞 Support

Found a bug? Have a feature request?
Open an issue on GitHub!

📊 Project Stats

Code Size Last Commit

Made with ❤️ and a focus on privacy & security

About

A customizable browser start-page built as a simple but cool project in polishing my front end skill while also getting the gist of how Angentic tools work.Its's built with vanilla JavaScript and all data is stored locally in your browser, respecting your privacy. Let's FOSS!!

dailycosmos.netlify.app/

Resources

Readme
MIT license
Activity

Stars

6 stars

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages