This document explains the changes made during the refactoring to follow Val Town's recommended project structure.

• Before: Monolithic structure with mod.ts, pkg/, and build.ts
• After: Clean separation with backend/, frontend/, and dedicated files

• mod.ts - Replaced by backend/services/rss.ts
• build.ts - Replaced by updateFeeds.cron.ts
• pkg/mod.ts - Logic moved to backend/services/rss.ts
• pkg/template.tsx - No longer needed (frontend handles rendering)

• feeds.json - Feed configuration (extracted from hardcoded array)
• backend/services/rss.ts - RSS processing service
• updateFeeds.cron.ts - Scheduled feed updates
• backend/README.md - Backend documentation

• http.ts - Now uses Hono framework with proper routing
• README.md - Updated with new structure and usage

- // Old: Simple passthrough
- export default function (req: Request) {
-   return tinyfeed.fetch(req);
- }

+ // New: Hono-based routing with proper error handling
+ const app = new Hono();
+ app.get("/api/data", async (c) => { ... });
+ export default app.fetch;

- // Old: unstorage with Val Town driver
- import valTownDriver from "https://esm.town/v/pomdtr/unstorage-driver/main.tsx";
- const storage = createStorage({ driver: valTownDriver({}) });

+ // New: Direct blob storage
+ import { blob } from "https://esm.town/v/std/blob";
+ await blob.setJSON("rss:app-data", data);

- // Old: Hardcoded in mod.ts
- feeds: [
-   "https://blog.val.town/rss.xml",
-   "https://blog.railway.com/rss.xml",
-   // ... more feeds
- ]

+ // New: External JSON configuration
+ // feeds.json
+ [
+   "https://blog.val.town/rss.xml",
+   "https://blog.railway.com/rss.xml",
+   // ... more feeds
+ ]

- // Old: Manual build trigger
- // Run build.ts manually

+ // New: Automated cron job
+ // updateFeeds.cron.ts runs every 6 hours automatically

• Clear separation of concerns
• Backend services isolated from HTTP handling
• Configuration externalized for easy updates

• Comprehensive error boundaries
• Individual feed failures don't block others
• Proper HTTP status codes and responses

• Uses Hono framework for HTTP handling
• Proper static file serving with Val Town utilities
• Follows recommended directory structure

• Automatic scheduled updates
• Better API design
• Improved logging and monitoring

1. ✅ Created feeds.json with feed configuration
2. ✅ Built backend/services/rss.ts with separated concerns
3. ✅ Refactored http.ts to use Hono framework
4. ✅ Created updateFeeds.cron.ts for automated updates
5. ✅ Updated documentation and README
6. ✅ Cleaned up old files

1. Review feeds.json - Verify all your feeds are included
2. Test the endpoints - Visit your app URL to ensure everything works
3. Schedule the cron job - Set up updateFeeds.cron.ts to run every 6 hours

1. Adjust cron frequency - Modify the schedule in updateFeeds.cron.ts
2. Add more feeds - Simply edit feeds.json
3. Customize UI - Modify React components in frontend/
4. Add API features - Extend routes in http.ts

Data not loading?

• Run updateFeeds.cron.ts manually to populate initial data
• Check blob storage keys are prefixed with rss:

Feeds not updating?

• Verify cron job is scheduled and running
• Check console logs for feed fetch errors

Frontend not loading?

• Ensure static file serving is working
• Check that frontend/index.html exists

Check the following files for detailed information:

• backend/README.md - Backend service documentation
• README.md - Overall project documentation
• Console logs during cron job execution

• Feeds are now fetched in parallel for better performance
• Failed feeds don't block successful ones
• Results are cached in blob storage between updates
• Frontend loads data asynchronously for better UX

The refactoring is complete and your RSS aggregator now follows Val Town best practices while maintaining all existing functionality with improved reliability and maintainability.