A calm, privacy-first devotional companion for Web, PWA & Chrome.
Daily wisdom • Mantras • Japa • Panchang • Festivals • Meditation
DharmaPulse is an original, account-free devotional experience designed for a simple daily rhythm of reflection.
It brings spiritual content and practical devotional tools together in one focused interface—without requiring an account or a paid API.
One app. One calm moment. Every day. 🪔
| 🏠 Daily | 📅 Calendar | 📿 Practice | 🧘 Wellness |
|---|---|---|---|
| Daily wisdom & blessing | Festivals & Panchang | Mantras & Japa | Meditation timer |
| Devotional questions | Deity explorer | 11 / 21 / 54 / 108 counts | Personal totals |
| Telugu / English | Regional coordinates | TTS & sharing | Local history |
- Daily devotion, blessing, wisdom and reflection
- 366-entry content cycle for day-by-day coverage, including leap years
- Telugu / English preference persistence
- Offline Panchang calculation
- Configurable latitude / longitude
- Festival calendar with regional/traditional accuracy guidance
- Clear informational disclaimer for observance decisions
- Searchable deity explorer
- Deity detail views
- Mantra library
- Text-to-speech in English / Telugu
- Native sharing with clipboard fallback
- Japa counter: 11 / 21 / 54 / 108
- Meditation sessions: 5 / 10 / 15 / 20 / 30 minutes
- Local Japa and meditation totals
- Devotional history
- Installable PWA
- Offline cache through service worker
- Dark mode
- Local favorites
- PNG devotional share-card generator
- JSON backup / restore
- Local reset controls
- Browser / PWA notification permission test
- Daily devotional experience from the browser
- Configurable reminder time
- DST-safe reminder handling
- Extension options page
- Shared content library with the web app
┌─────────────────────┐
│ Shared Content │
│ JSON Library │
└──────────┬──────────┘
│
┌───────────────┴───────────────┐
▼ ▼
┌──────────────┐ ┌──────────────┐
│ Web / PWA │ │ Chrome │
│ │ │ Extension │
└──────┬───────┘ └──────┬───────┘
│ │
└──────────────┬───────────────┘
▼
┌─────────────────────────┐
│ Daily Devotional Flow │
│ │
│ Wisdom → Mantra → │
│ Blessing → Reflection │
└─────────────────────────┘
DharmaPulse intentionally keeps the core experience local and lightweight:
- No login required
- No paid API dependency
- Local favorites and history
- Local backup / restore
- Offline-friendly architecture
- Shared static content for web + extension
- Node.js 22.x
- npm
- Git
npm install
npm run devThen open the local development URL shown by Next.js.
npm run buildnpm run lint
npm run test:content
npm run test:panchang
npm run test:smokeThe repository maintains one canonical extension implementation under extension/.
- Open Chrome → Extensions → Manage Extensions
- Enable Developer mode
- Choose Load unpacked
- Select the built extension directory produced by the project
- Open Details → Extension options to configure the reminder
The extension packaging workflow is maintained separately from the web application build so extension regressions can be detected early.
DharmaPulse uses automated quality gates for the core project:
- ✅ Lint validation
- ✅ Content integrity tests
- ✅ Panchang tests
- ✅ Smoke tests
- ✅ Production build validation
- ✅ Chrome extension validation / packaging
- ✅ GitHub Actions CI
- ✅ PWA / offline architecture checks
For releases, test the deployed experience on mobile and desktop, including offline mode, PWA installation, Panchang, Japa, backup/restore and extension options.
DharmaPulse/
├── app/ # Next.js application
├── extension/ # Canonical Chrome extension
├── public/ # Static assets & shared content
├── scripts/ # Build / validation utilities
├── tests/ # Automated tests
├── .github/workflows/ # CI & deployment workflows
├── next.config.* # Next.js configuration
├── package.json # Scripts & dependencies
└── README.md # Project documentation
DharmaPulse supports a Telugu / English devotional experience with browser speech support.
The goal is a distraction-free interface that works comfortably across desktop and mobile form factors.
Panchang calculations depend on coordinates and calendar conventions. Festival observance can vary by region, tradition and local panchang.
DharmaPulse therefore presents reference information and recommends verifying important observance dates with the user's local or family panchang.
DharmaPulse is an informational devotional companion, not a replacement for a traditional/local panchang.
DharmaPulse is designed around a no-account, local-first experience.
The application does not require a paid external API for its core devotional features. Local user data such as favorites, history and counters is intended to remain on the user's device unless the user explicitly exports it.
Future improvements should strengthen the existing experience rather than duplicate features:
- 🎨 Refine visual polish and accessibility
- 📅 Improve regional calendar guidance
- 📿 Expand devotional practice utilities
- ⚡ Keep performance and offline reliability high
- 🔐 Preserve the local-first privacy model
- 🧪 Continue automated quality coverage
Contributions, bug reports and thoughtful improvements are welcome.
- Fork the repository.
- Create a focused feature or fix branch.
- Make the smallest change that solves the problem.
- Run the complete local quality checks.
- Open a pull request with a clear description of the change.
Before opening a pull request:
npm install
npm run lint
npm run test:content
npm run test:panchang
npm run test:smoke
npm run buildPlease keep contributions focused, accessible, privacy-friendly and consistent with the existing DharmaPulse experience. Avoid duplicate functionality and do not commit secrets, API keys, credentials or personal data.
For detailed contribution guidance, see CONTRIBUTING.md.
DharmaPulse follows a local-first approach and does not require accounts or paid APIs for its core experience.
- 🔒 Keep user data local wherever practical
- 🚫 Never commit secrets, tokens, credentials or private keys
- 🧹 Avoid collecting unnecessary personal data
- 📦 Keep dependencies and build tooling maintained
- 🧪 Run automated quality checks before changes are merged
- 🌐 Review external links, permissions and browser capabilities carefully
Please do not disclose security vulnerabilities in public GitHub issues.
Use the repository's GitHub Security / Private vulnerability reporting channel when available. If private reporting is unavailable, contact the repository maintainer privately through GitHub before publicly disclosing sensitive details.
See SECURITY.md for the reporting policy.
DharmaPulse is distributed under the MIT License.
See LICENSE for the complete license text.