flowchart TD accTitle: Project Overview accDescr { NutsNews is a calm, mobile-first positive news platform powered by automation, AI curation, serverless infrastructure, CDN caching, centralized observability, and a private admin … } rss["RSS sources"] --> controller["Controller Worker\n(orchestration)"] controller --> shards["Cloudflare Worker shards\nrefresh loop"] shards --> ai["AI curation and filtering"] ai --> storage["Supabase + PostgreSQL\nstorage"] storage --> api["Worker DB API / App DB API"] api --> web["Next.js web + admin"] web --> readers["Readers\npublic + feed cards"] ops["Ops stack"] --> repo["docs/repo workflows"] ops --> observability["Monitoring, logs, uptime"] observability --> web web --> ops storage --> feedSnapshot["public_feed_snapshot\npublic projection"] feedSnapshot --> readers web --> preview["/opengraph-image previews"]

Project Overview

NutsNews is a calm, mobile-first positive news platform powered by automation, AI curation, serverless infrastructure, CDN caching, centralized observability, and a private admin portal.

The platform collects uplifting stories from trusted RSS feeds, filters out stressful topics, creates short cheerful summaries, and links readers back to the original publishers.

Mission

NutsNews exists to make positive stories easier to find.

The platform focuses on stories about:

Community
Wellness
Science
Culture
Animals
Travel
Lifestyle
Nature
Space
Creativity
Human achievement
Inspiring people
Helpful discoveries
Remarkable moments

The goal is not to become a traditional newsroom.

The goal is to become a fully automated positive-news discovery layer that helps readers find uplifting stories from around the web.

What NutsNews Avoids

NutsNews intentionally avoids content that creates stress or conflict.

The platform is designed to filter out stories mainly focused on:

Politics
War
Crime
Tragedy
Violence
Fear
Market panic
Financial stress
Election conflict
Government conflict
Outrage-driven news

This editorial direction keeps the product focused and gives the site a clear identity.

Product Experience

NutsNews is designed for quick mobile reading.

Each story card gives the reader:

A clear title
A short cheerful summary
A source label
A published date
Category badges
A story image when available
A link to the original publisher

The homepage behaves like a calm feed of uplifting stories rather than a noisy news portal.

Source-Friendly Publishing

NutsNews does not replace the original article.

It stores and displays:

The original title
The source name
A short original summary
The category
The article image when available
The link back to the original publisher

This supports discovery while respecting the original publisher.

Open Graph Image Generation

NutsNews includes branded Open Graph image generation for social sharing.

Routes:

/opengraph-image
/articles/[id]/opengraph-image

Generated images use the NutsNews dark-and-amber visual system and are sized for large social previews:

1200 × 630

Homepage previews include:

NutsNews branding
Product tagline
Positive-news positioning
Amber visual treatment

Article previews include:

Article title
Article summary
Source name
Category badge when available
NutsNews branding

Project Benefits

For readers

NutsNews provides a calmer alternative to stressful news feeds.

For publishers

NutsNews sends readers back to the original source instead of replacing the publisher’s content.

For operators

The system is automated, monitored, logged, protected, and designed to run at low cost.

For developers

The architecture is modular, serverless, and easy to extend.

For the business

The platform can become the foundation for a fully automated positive-news agency.

Current Status

NutsNews currently includes:

A public mobile-first website
RSS-based content discovery
AI assisted article filtering
AI-generated short summaries
Supabase article storage
Cloudflare Worker automation
Worker sharding
Controller Worker orchestration
Cloudflare CDN caching
Better Stack uptime monitoring
Better Stack centralized structured logs
Sentry error monitoring
Google-protected admin portal
AI Usage dashboard
Worker Health dashboard
RSS feed health dashboard
Feed management dashboard
Dynamic Open Graph image generation
Optimized public article API pagination
Database indexes for feed and article API performance
GitHub documentation in docs/
Production troubleshooting guide
MIT license

Primary diagram