How dhaksh-m/credora works
Credora is an offline-first Electron desktop platform for creating, issuing, managing, and verifying certificates. The principal workflow is to design a template, import and validate recipient data, generate certificates, then optionally enqueue campaign email; users can also browse, revoke, export, and locally verify certificates. The Electron main process initializes storage and the database, while IPC exposes backend operations to the React app. Edges reflect shown calls and documented behavior; some renderer-to-IPC wiring and unsampled subsystem details are not visible, so those relationships are omitted.
Main entry points: ipc/index.ts IPC handlers · src/index.ts Certificate issue and export · storage/index.ts User file workspace · main.ts Electron main
Components 24
Desktop interface
- React application
src/app/App.tsx - Dashboard
src/pages/dashboard/Dashboard.tsx - Template editor
src/pages/create/Editor.tsx - Campaigns view
src/pages/campaigns/Campaigns.tsx - Certificates view
src/pages/certificates/Certificates.tsx - Verification view
src/pages/verification/Verify.tsx - Settings view
src/pages/settings/Settings.tsx
Electron runtime
- Electron main
electron/main.ts - IPC handlers
electron/ipc/index.ts - Job recovery
electron/services/jobs.ts
Certificate lifecycle
- Campaign orchestration
electron/services/campaigns.ts - Certificate issue and export
packages/certificate-engine/src/index.ts - Local verification
electron/services/verification/index.ts - Email delivery
packages/email-engine/src/index.ts
Local data and files
- SQLite database
electron/services/database/index.ts - Data schema
database/schema/schema.ts - Template persistence
electron/services/database/templates.ts - Settings persistence
electron/services/database/settings.ts - User file workspace
electron/services/storage/index.ts
Processing engines
- Spreadsheet import
packages/excel-engine/src/index.ts - Recipient validation
packages/validation/src/index.ts - Shared certificate types
packages/shared-types/src/index.ts
Other components
- Desktop user
- SMTP service
Connections 27
- Desktop user → React application: uses
README.md - Electron main → React application: loads interface
electron/main.ts - Electron main → User file workspace: initializes
electron/main.ts - Electron main → SQLite database: initializes
electron/main.ts - Electron main → Job recovery: recovers jobs
electron/main.ts - Electron main → IPC handlers: registers handlers
electron/main.ts - IPC handlers → Campaign orchestration: dispatches campaign
electron/ipc/index.ts - IPC handlers → Certificate issue and export: dispatches certificates
electron/ipc/index.ts - IPC handlers → Local verification: dispatches verification
electron/ipc/index.ts - IPC handlers → Email delivery: dispatches email
electron/ipc/index.ts - IPC handlers → User file workspace: dispatches file tasks
electron/ipc/index.ts - IPC handlers → Template persistence: dispatches templates
electron/ipc/index.ts - IPC handlers → Settings persistence: dispatches settings
electron/ipc/index.ts - Campaign orchestration → SQLite database: records campaign
electron/services/campaigns.ts - Campaign orchestration → Certificate issue and export: generates certificates
electron/services/campaigns.ts - Campaign orchestration → Email delivery: queues delivery
electron/services/campaigns.ts - Certificate issue and export → SQLite database: reads and writes
packages/certificate-engine/src/index.ts - Certificate issue and export → User file workspace: writes outputs
packages/certificate-engine/src/index.ts - Certificate issue and export → Shared certificate types: uses helpers
packages/certificate-engine/src/index.ts - Email delivery → SQLite database: reads and records
packages/email-engine/src/index.ts - Email delivery → SMTP service: sends mail
packages/email-engine/src/index.ts - SQLite database → Data schema: initializes from
electron/services/database/index.ts - User file workspace → Spreadsheet import: parses spreadsheet
electron/services/storage/index.ts - User file workspace → Recipient validation: validates recipients
electron/services/storage/index.ts - User file workspace → Certificate issue and export: creates archive
electron/services/storage/index.ts - Spreadsheet import → Shared certificate types: uses types
packages/excel-engine/src/index.ts - Recipient validation → Shared certificate types: uses types
packages/validation/src/index.ts