Skip to content

Ferki-git-creator/bytewise-search

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ByteWise Search is an innovative open-source search engine designed for maximum traffic efficiency, blazing speed, and uncompromising privacy. It operates entirely client-side (in your browser) using free web technologies, powered by a local, community-driven database of links.

✨ Key Features

Feature Benefit
🌐 Zero Hosting Costs Fully hosted on GitHub Pages, no server infrastructure needed.
🚀 Exceptional Traffic Savings Near-zero traffic consumption for search queries due to local data processing and caching.
⚡ High-Speed Performance Instant loading + offline access via Service Worker and Web Worker for background data processing.
🤝 Community-Driven Database Search results are powered by a local, extensible database that can be contributed to by users.
🔒 Privacy-First Approach All search history and data processing stored locally in your browser; no data ever leaves your device.

📊 Performance & Privacy Highlights

Parameter ByteWise Search
Initial Load ~24KB
Search Query 0KB (after initial data load and caching)
Response Speed Instant (from cache/local processing)
Offline Functionality ✅ Yes
External API Calls ❌ None for search results
User Tracking ❌ None

🚀 Getting Started

  1. Live Demo:
    https://ferki-git-creator.github.io/bytewise-search/

  2. Source Code:
    https://github.com/ferki-git-creator/bytewise-search

🛠️ Technical Architecture

ByteWise Search leverages modern browser technologies to deliver a powerful search experience without a backend server.

graph LR
    A[User Browser] --> B[Service Worker]
    B --> C{Cache Check}
    C -->|Cache Hit| D[Instant Results Display]
    C -->|Cache Miss| E[Web Worker (Local Database)]
    E --> F[Process Query + Rank Results]
    F --> G[Cache Results to IndexedDB]
    G --> D
Loading

🌟 Why Choose ByteWise?

  • Complete Data Sovereignty: Your searches and personal contributions never leave your device.
  • Network Adaptive: Optimized performance even on 2G/3G networks, as most operations are local.
  • Resource Efficient: Minimal data transfer after the initial application load, saving your mobile data.
  • Zero-Tracking: No cookies, no analytics, no fingerprints – your privacy is paramount.
  • Empowering Community: The search engine's knowledge base can grow and improve with user contributions. 💡 How to Contribute to ByteWise Search ByteWise Search thrives on community contributions! You can help make it better by adding new, relevant links.
  • Add Links Locally:
    • On the ByteWise Search website, click the "Contribute" button in the footer.
    • Fill out the form with a search query, link title, URL, description, and category.
    • Click "Add Link Locally". Your contribution will be saved in your browser's local database and immediately available in your personal search results.
  • Export Your Contributions:
    • In the "Contribute" modal, click "Export My Contributions".
    • This will download a JSON file (my_bytewise_contributions.json) containing all your local additions.
  • Share with the Community via GitHub:
    • To make your contributions available to all ByteWise Search users, you can submit them to the main project.
    • Fork the ByteWise Search GitHub repository.
    • Manually integrate the data from your my_bytewise_contributions.json file into the worker.js file (specifically, you can add new curated entries or extend the synthetic data generation logic if you're a developer).
    • Create a Pull Request (PR) to the main repository.
    • Once your PR is reviewed and merged, your contributions will be included in the next public deployment of ByteWise Search on GitHub Pages, benefiting the entire community!

About

A private, fast, and extremely energy-efficient search engine that runs entirely in your browser.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published