SubNotes

Inspiration

Content moderation on massive social platforms often falls into binary trap doors: either leave misleading content up and risk real-world harm, or tear it down completely and face intense accusations of centralized censorship. Reddit’s subreddit structure relies heavily on human moderators who are constantly overwhelmed by high-velocity content queues.

We were inspired by X Community Notes to build a decentralized, crowd-sourced context engine called SubNotes. The goal was to give subreddits an alternative to blunt removal actions. Instead of a single mod having to fact-check an entire thread or delete a complex discussion, the community collaboratively sources clarifying context and references. This shifts the mod’s role from an outright censor to an ultimate verification gatekeeper, ensuring transparency while keeping communities safe.

How We Built It

SubNotes is engineered entirely on Reddit’s modernized, Vite-powered Developer Platform (Devvit), completely bypassing legacy blocks syntax in favor of the full HTML/TypeScript webview stack.

• The Backend Rules Engine: Built using a serverless Hono framework running inside Reddit's isolated runtime environment. It serves as a secure firewall, preventing client-side data tampering and handling structural logic.
• The Frontend Matrix: A lightweight React 19 interface optimized for speed and styled with high-contrast, utilitarian design rules. It renders a clean, persistent visual banner at the top of custom post types when a note achieves consensus.
• The Persistence Layer: Powered entirely by Devvit Redis. We utilized atomic hash-set maps to keep tracking counters for upvotes, downvotes, and custom multi-choice evaluation criteria completely free of performance bottlenecks or race conditions.

Challenges We Faced

The absolute biggest hurdle was designing a high-fidelity crowd-sourced rating loop within the strict constraints of Reddit's serverless sandboxing rules. Because we cannot inject arbitrary code directly over standard native text threads, we had to rethink the delivery mechanism entirely and pivot toward a unified Custom Post Type wrapper.

Additionally, standard popularity upvotes can easily lead to ideological dogpiling on sensitive posts. Replicating a lightweight version of a consensus algorithm meant we couldn't just check for raw vote counts. We had to implement a custom schema to track qualitative metrics, such as whether a voter marked a note as using "neutral language" or providing "clear, high-quality sources."

Finally, balancing algorithmic consensus with Reddit's traditional moderator hierarchy required a thoughtful override architecture. We solved this by mapping moderator user IDs on the backend, granting them a direct, secure fast-track utility to instantly verify and pin a context banner regardless of current crowd scores.

What We Learned

Building SubNotes in a single day forced us to master Devvit Web's compilation architecture and asset-routing pipeline inside VS Code's Playtest live hot-reload loop. We learned how to deeply optimize Redis transaction state lifetimes within a serverless ecosystem to prevent stale UI states.

Most importantly, we proved that decentralized engineering tools can co-exist beautifully with hierarchical community structures, proving that community-driven fact-checking is a viable, scalable alternative to heavy-handed moderation.

Built With

• ctx.redis
• devvit
• hono
• reddit