Loading...
Product
Core Features
Top Extensions
Company
Track Your Charity & Sadaqah Contributions
Raycast extension for tracking your charitable giving (Sadaqah) with multi-currency support and gold value conversion.
Sponsored by erklab — Architecting production-grade systems with AI-driven velocity and human-centered precision.
⌘⇧1-5 for quick preset accesscrypto.randomUUID() for ID generationgit clone <repository-url>
cd sadaqahbox-raycast
npm install
Configure the extension in Raycast:
https://api.yourdomain.com)Build and install:
npm run build
| Setting | Description | Required |
|---|---|---|
| API Host | Base URL of your SadaqahBox API | Yes |
| API Key | Better Auth API key for authentication | Yes |
Command: Dashboard
Main interface for managing your sadaqah boxes:
Command: Manage Presets
Configure quick-add presets:
src/
├── api/
│ ├── client.ts # Base HTTP client with timeout & retry
│ ├── index.ts # API endpoint functions
│ └── cached.ts # Cached API wrappers
├── constants/
│ └── index.ts # App constants & configuration
├── utils/
│ ├── cache.ts # Raycast Cache utilities
│ ├── error-handler.ts # Error categorization & sanitization
│ ├── security.ts # Secure ID generation
│ └── type-guards.ts # Runtime type checking
├── validation/
│ └── schemas.ts # Zod validation schemas
├── data/
│ ├── quotes.json # Quranic verses & Hadith on sadaqah
│ └── quotes.ts # Quote types & utilities
├── services/
│ └── quote-service.ts # Random quote generation
├── dashboard.tsx # Main dashboard command
├── box-detail.tsx # Box detail view
├── create-box.tsx # Create box form
├── edit-box.tsx # Edit box form
├── add-sadaqah.tsx # Add sadaqah form
├── manage-presets.tsx # Preset management
├── collection-detail.tsx # Collection receipt view
├── presets-storage.ts # LocalStorage for presets
├── auth-client.ts # Better Auth client setup
└── types.ts # TypeScript type definitions
The extension communicates with a SadaqahBox backend API. All API calls include:
x-api-key header| Endpoint | Cache TTL | Invalidation |
|---|---|---|
| List Boxes | 5 minutes | On create/update/delete |
| Get Box | 5 minutes | On update/delete |
| Stats | 2 minutes | On any mutation |
| Currencies | 1 hour | On currency changes |
| Currency Types | 1 hour | On type changes |
| Sadaqahs | No cache | Real-time data |
| Collections | No cache | Real-time data |
# Development mode with hot reload
npm run dev
# Build for production
npm run build
# Run linting
npm run lint
# Fix linting issues
npm run fix-lint
# Publish to Raycast Store
npm run publish
src/api/index.ts and wrap in src/api/cached.tsvalidation/schemas.ts for validationsrc/ and register in package.jsonAll user inputs are validated using Zod schemas:
"API Key is not configured"
"Request timed out"
"Failed to load data"
To see detailed error logs:
git checkout -b feature/amazing-feature)git commit -m 'Add amazing feature')git push origin feature/amazing-feature)MIT License - see LICENSE file for details
May your sadaqah be accepted 🤲
View and manage your sadaqah boxes
Manage your sadaqah presets for quick action
⌘⇧1-5 for instant preset actions⌘⇧↑/↓ keyboard shortcutscrypto.randomUUID() for all ID generationx-api-key header with Better AuthDashboard – Main interface for viewing and managing all sadaqah boxesManage Presets – Configure quick-add presets for faster donation recording