DEV Community

Cover image for What If Every Act of Kindness Could Create Another One?
gulnur
gulnur

Posted on

What If Every Act of Kindness Could Create Another One?

#devchallenge #weekendchallenge

DEV Weekend Challenge: Generosity Edition Submission 💜

This is a submission for Weekend Challenge: Generosity Edition

What I Built

In celebration of the UN International Day of Charity (September 5), I built OpenImpact — a transparent grassroots giving platform and generosity ledger designed to eliminate donor skepticism and celebrate the contagious nature of community kindness.

Traditional charity platforms often suffer from the "black-box" dilemma: donors contribute to nebulous general funds without ever knowing what their money bought, while small community initiatives lack the marketing muscle to tell their stories transparently.

OpenImpact solves this through four core pillars:

  1. Concrete Unit Economics & Visual Impact Calculator: Instead of throwing money into an abstract pool, donors use an interactive slider with dynamic Recharts bar charts to see exactly how their contribution translates into tangible units (e.g., $18 = 1 Solar Desk Lantern replacing toxic kerosene smoke, $12 = 24 lbs of rescued fresh produce, or 2 hours = 1 youth coding mentorship kit).
  2. AI-Powered Field Storyteller (Google Gemini): Small nonprofits often don't have PR teams. Changemakers simply upload raw field notes or receipt summaries, and Gemini transforms them into audit-ready, authentic field dispatches and ready-to-publish Dev.to Markdown posts.
  3. The Generosity Ripple Engine: Generosity is contagious. OpenImpact maps out connected chains of giving, proving that every act of kindness inspires subsequent pledges (tracking real-time ripple multipliers).
  4. Radical Transparency & Busters of the "Overhead Myth": The platform publishes itemized accounting, open receipts, and downloadable CSV audits, proving that ethical compensation for local workers creates sustainable impact.

Demo

  • 🌐 Live Web Application: OpenImpact Live Demo
  • 📊 Interactive Features to Try:
    • Open any cause and click "Simulate & Pledge" to see the real-time Recharts bar chart calculator and trigger the confetti celebration.
    • Navigate to "Field Storyteller" and click "Generate Dispatch with Gemini" to test raw field note conversion into transparent community dispatches.
    • Visit the "Generosity Ripple" tab to see how acts of giving propagate across donors.
    • Check the "Open Audit" tab to inspect itemized budget allocations and download the open CSV ledger.

Code

GitHub logo Gulnur-Altan / OpenImpact

A transparent grassroots giving and storytelling platform crafted specifically for the DEV.to International Day of Charity Challenge.

🌱 OpenImpact

What if every act of kindness could create another one?

OpenImpact is an open-source generosity platform focused on transparency, measurable impact, and the ripple effect of giving.

✨ Features

  • 💰 Impact Calculator — See what a contribution can achieve through interactive charts.
  • 🤖 AI Field Storyteller — Turn raw field notes into authentic impact stories with Google Gemini.
  • 🌊 Generosity Ripple — Visualize how one act of generosity inspires another.
  • 🔎 Open Audit — Explore itemized budgets and download the public CSV ledger.

🛠️ Tech Stack

  • React
  • Recharts
  • Google Gemini
  • JavaScript
  • CSS

🚀 Demo

OpenImpact Live Demo

Try Simulate & Pledge, Field Storyteller, Generosity Ripple, and Open Audit.

🤝 Contributing

Contributions are welcome! Fork the repository, create a feature branch, make your changes, and open a Pull Request.

📄 License

This project is licensed under the MIT License.

🏆 DEV Community Challenge

…
View on GitHub

How I Built It

Tech Stack:

  • Frontend: React 19, TypeScript, Tailwind CSS, Recharts (for dynamic unit yield charts), Lucide Icons, Canvas Confetti.
  • Backend: Node.js, Express, tsx, esbuild.
  • AI & Intelligence: Google Gemini 3.8 Flash via the @google/genai TypeScript SDK.

Technical Architecture & Decisions:

  • Server-Side API Proxy for Gemini Security: All interactions with Google Gemini run via secured Express routes (/api/generate-dispatch and /api/simulate-impact), ensuring API credentials are never exposed client-side.
  • Auditing Prompt Engineering: The Gemini prompt explicitly enforces ethical storytelling rules: rejecting corporate marketing buzzwords ("supercharge", "synergy"), emphasizing dignity and concrete metrics, and formatting verified receipts into structured JSON and clean Markdown.
  • Resilient AI Fallback Engine: Built an intelligent local synthesizer fallback so that if external rate limits or transient spikes occur, the user experience never breaks or crashes.
  • Accessible Visualization: Designed horizontal Recharts bars with custom tooltips displaying division formulas (e.g., $90 ÷ $18/unit = 5.0 lanterns) so every calculation is auditable.

Prize Categories

🏆 Best Use of Google AI

OpenImpact leverages Google Gemini 3.8 Flash via the official @google/genai SDK to solve real pain points in charitable giving:

  • Democratizing Non-Profit Communication: Grassroots leaders often have field evidence but lack copywriters. Gemini ingests unpolished bullet points and receipts, extracting verified outcomes, human quotes, and itemized ledger tables without corporate fluff.
  • Contextual Impact Simulation: When donors pledge volunteer hours or micro-funds, Gemini projects contextual community ripple effects on the fly.

Top comments (0)