@ayco/cozy
v0.3.3
Published
<p align="center"> <img src="https://github.com/user-attachments/assets/e49b56a7-cc0f-45a3-98e0-8bbcbd02a47c" alt="COZY logo" /><br /> Remove distractions. Save for later.<br /> Cozy is your modern-day reading companion. </p> <p align="center"> <a
Downloads
3
Readme
Why?
Visiting websites in this 'modern' time is a paradox: standard Web technologies are better but most commercial websites are pretty terrible--not only because misinformation abounds online, but also because of Big Tech's personal data farming that puts us all at a disadvantage.
Cozy addresses this by putting people first by default: no tracking cookies will ever get into your browser, pay the minimum bandwidth to get information you need, and save everything on your browser for accessing them again later offline.
With Cozy: The Web is Yours.
How is this app different?
Here's what this project is building:
- An app that just works, no sign-ups or set-ups.
- Progressively enhanced experience. Main feature works even without JS. Removing distractions happen on the server and dead clean HTML gets delivered
- All your data are cached and does not leave your device; offline access is by default
- Cloud-sync will be opt-in, with your choice of provider
- Will also explore smart insights, such as:
- text summarization
- dominant emotion
- other sources for lateral reading
Roadmap
| Feature | Status | Version | | --- | --- | --- | | Remove distractions| ✅ DONE | v0.0.x | | Save viewed history | ✅ DONE | v0.1.x | | Open links within Cozy | ✅ DONE | v0.2.x | | Offline access | ✅ DONE | v0.3.x | | Set items as Favorites | 🛠️ In-progress | v0.4.x | | Smart insights | | v0.5.x | | Browser Extensions | | | | Native Apps | | |
Usage / Options
1. Copy, Paste
It's simple. When you open an article and want to turn it into a more cozy reading experience, just copy the url and paste it to the app's address bar.
2. One-click Bookmark
A bookmarklet could run a script to open the current page for you on ~~Cozy~~. You can create this new bookmark titled 'Get cozy!' and put the following as value for the URL:
javascript:(function(){ window.open('https://cozy.pub/?url=%27 + window.location.href, %27_self%27); })();
This is possible on all major browsers, including Safari on iOS (where I personally use this often). Some screenshots:
| Firefox | Chrome | | --- | --- | | | |
3. One-click Extension then...
It doesn't exist yet... I'll probably get to creating a browser extension at some point. But for now, PRs welcome! :)
Credits
We are thankful for all the building blocks provided by the following projects:
- Astro for our server-side rendering framework
- @ayco/astro-resume for communicating necessary data from server to client
- @ayco/astro-sw for taking app's service worker, and injecting needed dynamic assets & variables
- @extractus/article-extractor for the amazing scraping of articles
- astro-iconify for easily using icon-sets in iconify
- ultrahtml for any cleanup and transformation we do on the received article content
- fastify for our production server and nginx as reverse proxy
Contributing
If any of the above seems to need improvement for you, we are always eager to hear feedback and welcome all contributions. See our CONTRIBUTING guide for more info.
Join our Discord if you need help!