Authentic Islamic education — courses, books, community, and mentorship, with payments on Stellar.
Deen Bridge is a modern learning platform that connects Muslims worldwide with authentic Islamic knowledge. Learners enroll in interactive courses, read from a digital library, join live community spaces, message mentors directly, and get instant answers from an Islamic-knowledge AI assistant. Courses and books are purchased with USDC on the Stellar network — non-custodial, with creators paid directly to their own wallets.
This repository is the web client. The platform is composed of three services:
| Repository | Role | Live |
|---|---|---|
| dnb-frontend (this repo) | Next.js web application | dnb-frontend.vercel.app |
| dnb-backend | REST API — auth, content, Stellar payments | dnb-backend-api.onrender.com |
| dnb-ai | FastAPI service for the AI assistant | dnb-ai.onrender.com |
- 🎓 Interactive Courses — enroll, learn, review, and track progress
- 📚 Digital Library — read Islamic books online with a built-in PDF reader
- 💬 Community Spaces — live sessions and video rooms with mentors
- 🎬 Reels — short-form Islamic content
- ✉️ Direct Messaging — real-time chat between students and mentors
- 🤖 AI Assistant — Islamic-knowledge chatbot with conversation history
- ⭐ Stellar Payments — buy courses and books with USDC; creators are paid directly
- 👛 Multi-Wallet Support — Freighter, xBull, and Albedo via Stellar Wallets Kit
- 🔒 Role-Based Access — student, mentor, and admin experiences
| Layer | Technology |
|---|---|
| Framework | Next.js 15 (App Router) · React 19 |
| Styling | Tailwind CSS v4 · Radix UI · Framer Motion |
| Forms & Validation | React Hook Form · Zod |
| Blockchain | @stellar/stellar-sdk · Stellar Wallets Kit |
| Data & Media | Axios · Firebase · Vidstack · pdf.js |
- Node.js 20+
- npm (or yarn/pnpm)
git clone https://github.com/Deen-Bridge/dnb-frontend.git
cd dnb-frontend
npm install
cp .env.example .env.local # then fill in your values
npm run devThe app runs at http://localhost:3000.
| Variable | Description |
|---|---|
NEXT_PUBLIC_API_URL |
Base URL of the dnb-backend API |
NEXT_PUBLIC_STELLAR_NETWORK |
testnet or public (mainnet) |
See .env.example for the full list.
| Command | Purpose |
|---|---|
npm run dev |
Start the development server (Turbopack) |
npm run build |
Production build |
npm run start |
Serve the production build |
npm run lint |
Run ESLint |
This repository participates in the Stellar Drips Wave bounty program — contributors earn Points (and real rewards) for resolving this repo's issues during a Wave, with complexity tiers set in the Drips Wave app.
- All pull requests target the
devbranch (mainis releases only) - CI (lint + build) must pass before review
- One contributor per issue — comment to claim it first
Read CONTRIBUTING.md for the full workflow, coding standards, and Wave rules.
MIT © Deen Bridge
- 🌐 Website: dnb-frontend.vercel.app
- 🐦 X/Twitter: @deen_bridge
- 🏢 Organization: github.com/Deen-Bridge