Skip to content

ayoayco/Cozy

COZY logo
Remove distractions. Save for later.
Cozy is your modern-day reading companion.

Last Commit Alpha

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:

  1. An app that just works, no sign-ups or set-ups.
  2. Progressively enhanced experience. Main feature works even without JS. Removing distractions happen on the server and dead clean HTML gets delivered
  3. All your data are cached and does not leave your device; offline access is by default
  4. Cloud-sync will be opt-in, with your choice of provider
  5. Will also explore smart insights, such as:
    1. text summarization
    2. dominant emotion
    3. 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
Screenshot from 2023-05-13 08-31-41 Screenshot from 2023-05-12 23-32-08

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:

  1. Astro for our server-side rendering framework
  2. @ayco/astro-sw for taking app's service worker, and injecting needed dynamic assets & variables
  3. @extractus/article-extractor for the amazing scraping of articles
  4. astro-iconify for easily using icon-sets in iconify
  5. ultrahtml for any cleanup and transformation we do on the received article content
  6. 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!