FinBento 📊

📰 Real-time finance news • 🧘 Focus Mode • 🌓 Dark Mode • 🔁 Auto-Refresh • 📁 Saved Articles • ✍️ Blog • ⚡ Fast, Static, Serverless

A bite-sized finance and investing news reader. FinBento keeps you in the loop — with clean headlines, curated sources, and no extra noise. Stay focused, stay informed.

🔗 Visit the live site:
https://finbento.com

☕ If you find FinBento useful:
Buy me a coffee at ko-fi.com to help me keep the lights on!

---

📋 Table of Contents

• 🌐 Demo
  • Screenshot
  • GIF
• ✨ Features
• 💻 Tech Stack
• 🏁 Getting Started
  • Prerequisites
  • Installation
  • Development
  • Deployment
• 🗺️ Roadmap
• 🤝 Contributing
• 📁 Repo Structure
• 📄 License
• 🙏 Acknowledgements

---

🌐 Demo

FinBento

Your daily bite of finance, investing, and money news.
Curated from trustworthy sources. Filtered for clarity.

(COMING SOON)

✨ Features

• 📈 Real-time finance headlines from trusted sources (MarketWatch, Seeking Alpha, CNBC, WSJ, etc.)
• 🔍 Filter by source — focus only on what you care about
• 🧘 Focus Mode — distraction-free reading view
• 🌓 Dark Mode — toggle anytime
• 📁 Saved Articles — save and export to read later
• 🔁 Auto-refresh every 10 minutes — always up to date
• 🔄 Manual refresh button — control when you want the latest
• ✍️ Built-in blog — behind-the-scenes insights and updates
• ⚡ Lightweight, fast, and serverless — deployed via Cloudflare Workers

💻 Tech Stack

🌀 Hosted entirely via Cloudflare Workers – combines serverless API logic and static content delivery in a single deployment.

• Platform & Hosting: Cloudflare Workers (API + static assets)
• Language & Frameworks: Vanilla JavaScript, HTML, CSS
• Storage: Browser LocalStorage
• Version Control: Git & GitHub
• No frameworks, no build step — just clean, readable code!

🏁 Getting Started

Prerequisites

• Node.js (for local Worker simulation, optional)
• Wrangler CLI (install instructions and CLI reference)
• A free Cloudflare account with Workers enabled

Installation

1. Clone the repo

git clone https://github.com/byte-bento/finbento.git
cd finbento

2. Install Wrangler (if not already)

npm install -g @cloudflare/wrangler

Development

You can preview the site and Workers locally using Wrangler.

# Log into Cloudflare
wrangler login
# Simulate Workers + static assets locally
wrangler dev

Open http://127.0.0.1:8787 in your browser to see live changes.

Deployment

Once you're happy with changes:

# Publish to your Cloudflare account
wrangler publish

🗺️ Roadmap

(COMING SOON)

🤝 Contributing

Want to improve FinBento or suggest a new feature? Awesome! We welcome all kinds of contributions, so let's make FinBento better together!

To get started:

1. Fork the repo
2. Create a branch (git checkout -b feature/awesome-thing)
3. Make your changes & commit with clear messages
4. Push to your fork (git push origin feature/awesome-thing)
5. Open a Pull Request against main

Be sure to:

• Review existing issues and add your thoughts
• Label any bugs you find or feature ideas you want to tackle
• Follow consistent code style (ESLint rules if you introduce new JS)

🪄 Whether it’s code, docs, or just ideas - contributions of all kinds are appreciated.

📁 Repo Structure

index.html           # Main landing page
script.js            # Core site logic (rendering, filters, fetch)
style.css            # Layout and visual styles
favicon.ico          # Site icon
finfav.png           # App icon/logo
/blog/               # Blog posts (markdown or html)

📄 License

This project is licensed under the MIT License.
Feel free to use, share, and remix—just give credit where it’s due.

🙏 Acknowledgements

• Inspired by the simplicity of serverless dashboards
• Thanks to Cloudflare Workers for the magic edge compute
• Hats off to all open-source libraries and contributors
• Made with ☕, 🧠, and 💻