Bringing radical transparency to charitable organizations' finances
A modern SaaS platform that enables 501(c)(3) charitable organizations to provide complete financial transparency to donors and the public. Starting with GRIT Hoops Westwood Basketball, Inc.
Production: radbooks.org — Hosted on Vercel with Neon PostgreSQL
Make financial transparency the norm for charitable organizations, enabling donors to see exactly how their contributions are used and building trust through radical openness.
- Real-time Financial Dashboard - View all income and expenses
- Historical Data Access - View financial state as of any past date
- Complete Audit Trail - See all changes with full transparency
- Donor Highlights - Recognize supporters (with opt-in)
- Program Spending - See what organizations plan to buy
- Completed Purchases Gallery - Photos of impact
- Historical Reports - Fiscal year comparisons and trends
- Secure Online Donations - Stripe-powered giving
- Multi-Organization Tracking - See giving across all supported orgs
- Impact Visibility - Track where your money went
- Anonymous Options - Donate privately if desired
- Automatic Receipts - Tax documentation
- General Ledger - Full double-entry bookkeeping
- Transaction Recording - Income and expenses
- Chart of Accounts - Hierarchical account structure
- Version History - Track all changes to accounts and settings
- Audit Trail - Complete change log with timestamps
- Program Spending Management - Track planned and actual spending
- Bill Management - Payables and receivables with payment tracking
- Bank Reconciliation - Match statements to ledger transactions
- Fundraising Campaigns - Fixed, tiered, and open campaigns
- File Attachments - Receipts and invoices on transactions/bills
- Financial Reports - Comprehensive reporting with historical accuracy
- Time Machine - View organization state as of any past date
- Bank Reconciliation - Match transactions to bank statements
- Multi-Tenant Management - Manage all organizations
- User Administration - Role-based access control
- System Analytics - Platform-wide insights
- Next.js 16 - React framework with App Router
- TypeScript - Type safety
- Tailwind CSS - Utility-first styling
- Shadcn/ui - Accessible component library
- Recharts - Data visualization
- Next.js API Routes - Serverless functions
- Prisma 7 - Type-safe ORM with bi-temporal versioning
- PostgreSQL - Primary database (Neon serverless in production)
- Zod - Runtime validation
- Vercel - Hosting and deployment
- Neon - Serverless PostgreSQL with branch databases
- Clerk - Authentication
- Vercel Blob - Private file storage (attachments)
- Resend - Transactional email
- DEV_SETUP.md - Development environment setup
- CONTRIBUTING.md - Code standards and contribution workflow
- APPROACH.md - System architecture and technical approach
- PROJECT_STRUCTURE.md - Folder structure and organization
- TEMPORAL_SCHEMA_DESIGN.md - Bi-temporal versioning patterns
- docs/adr/ - Architecture Decision Records
- DEPLOYMENT_SETUP.md - Production deployment guide
- PREVIEW_DEPLOYMENTS.md - Preview environments with Neon branches
- API_REFERENCE.md - API documentation for temporal endpoints
- CHANGELOG.md - Version history and release notes
- IMPLEMENTATION_CHECKLIST.md - Feature roadmap and progress
One-click reproducible development environment!
Prerequisites:
- Docker Desktop
- VS Code with Dev Containers extension
# 1. Clone the repository
git clone https://github.com/rtbooks/transparency.git
cd transparency
# 2. Test your setup (optional)
./test-devcontainer.sh
# 3. Open in VS Code
code .
# 4. Click "Reopen in Container" when prompted
# Everything else is automatic! ✨After the container starts (~5-10 mins first time):
npm run dev # Start developing!Benefits:
- ✅ No manual installation needed
- ✅ PostgreSQL pre-configured and running
- ✅ All dependencies installed automatically
- ✅ Consistent environment for all collaborators
- ✅ VS Code extensions pre-installed
See .devcontainer/README.md for full details.
Prerequisites:
- Node.js 18+
- PostgreSQL 14+
- npm or yarn
# Clone and navigate
git clone https://github.com/rtbooks/transparency.git
cd transparency
# Install dependencies
npm install
# Set up environment
cp .env.example .env.local
# Edit .env.local with your credentials
# Set up database
npx prisma generate
npx prisma db push
npx prisma db seed # Seeds sample data for GRIT Hoops (development only)
# Start development
npm run devNote: Database seeding is automatically skipped in production environments. The production database starts empty and organizations are created through the application UI.
Visit http://localhost:3000
For detailed manual setup instructions, see DEV_SETUP.md.
Current Phase: Production ✅ — Live at radbooks.org
- Core ledger (double-entry bookkeeping)
- Public transparency dashboard
- Bi-temporal versioning and audit trails
- Financial reports (Income Statement, Balance Sheet)
- Bills, contacts, and payment tracking
- Fundraising campaigns and donor workflows
- Bank reconciliation
- File attachments (receipts, invoices)
- Fiscal year-end closing
- Production deployment (Vercel + Neon)
- Donation processing (Stripe)
- Beta launch with GRIT Hoops
See IMPLEMENTATION_CHECKLIST.md for detailed progress.
Every financial transaction is visible to the public (except anonymous donor names). No hidden fees, no obscured expenses. Complete audit trail of all changes.
All financial data is versioned with complete history. Query the state of any account or organization as of any past date. Never lose information - all changes are tracked and reversible.
Professional accounting standards ensure accuracy and audit-ability. Every transaction affects two accounts.
Donors can track their impact across multiple organizations and see exactly where their money went.
Free tier for small organizations (<$50k annual revenue). Premium features at affordable prices. Never profit-seeking at the expense of charitable missions.
Donors control their visibility. Anonymous donations are fully supported and respected.
- End-to-end encryption for sensitive data
- PCI DSS compliance via Stripe
- Row-level security for multi-tenancy
- Regular security audits
- GDPR compliant
Free Tier (Small Organizations)
- Up to $50k annual revenue
- 100 transactions/month
- 1GB storage
- All core features
Premium - $29/month (Growing Organizations)
- Unlimited transactions
- 10GB storage
- Priority support
- Custom branding
Enterprise - $99/month (Large Nonprofits)
- Bank account sync
- QuickBooks integration
- Dedicated support
- Custom features
Advertising (Future)
- Ethical sponsor placements
- Revenue share with organizations
We welcome contributions! Please see CONTRIBUTING.md for guidelines.
- Fork the repository
- Create a feature branch:
git checkout -b feature/amazing-feature - Make your changes
- Run tests:
npm test - Commit:
git commit -m 'Add amazing feature' - Push:
git push origin feature/amazing-feature - Open a Pull Request
This project is licensed under the MIT License - see LICENSE for details.
- GRIT Hoops Westwood Basketball, Inc - Our first partner
- All the donors who believe in transparency
- The open-source community
- Website: radbooks.org
- Email: info@radbooks.org
- GitHub: github.com/rtbooks/transparency
This platform was designed with GRIT Hoops Westwood Basketball as the inaugural organization. Your mission to support the Westwood High School girls basketball program inspired this entire project.
- Transparent donation tracking
- Equipment purchase planning
- Travel expense visibility
- Donor recognition (opt-in)
- Annual reporting for IRS compliance
Built with ❤️ for charitable organizations everywhere
RadBooks — Making financial transparency the norm, not the exception.