{"id":50664764,"url":"https://github.com/ghwmelite-dotcom/funeral-press","last_synced_at":"2026-06-08T05:03:57.861Z","repository":{"id":339769245,"uuid":"1163299266","full_name":"ghwmelite-dotcom/funeral-press","owner":"ghwmelite-dotcom","description":"The all-in-one funeral planning platform for Ghana. Brochure design, memorial pages, live streaming, budget planning, guest books, and partner tools.","archived":false,"fork":false,"pushed_at":"2026-05-23T22:37:14.000Z","size":10403,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-24T00:21:13.350Z","etag":null,"topics":["cloudflare-workers","d1-database","funeral-planning","ghana","memorial","paystack","pwa","react","tailwindcss","zustand"],"latest_commit_sha":null,"homepage":"https://funeralpress.org","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ghwmelite-dotcom.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-21T12:14:01.000Z","updated_at":"2026-05-23T22:37:15.000Z","dependencies_parsed_at":"2026-02-21T19:01:08.502Z","dependency_job_id":null,"html_url":"https://github.com/ghwmelite-dotcom/funeral-press","commit_stats":null,"previous_names":["ghwmelite-dotcom/biography-builder","ghwmelite-dotcom/funeral-press"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ghwmelite-dotcom/funeral-press","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghwmelite-dotcom%2Ffuneral-press","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghwmelite-dotcom%2Ffuneral-press/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghwmelite-dotcom%2Ffuneral-press/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghwmelite-dotcom%2Ffuneral-press/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ghwmelite-dotcom","download_url":"https://codeload.github.com/ghwmelite-dotcom/funeral-press/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ghwmelite-dotcom%2Ffuneral-press/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34048707,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloudflare-workers","d1-database","funeral-planning","ghana","memorial","paystack","pwa","react","tailwindcss","zustand"],"created_at":"2026-06-08T05:03:57.589Z","updated_at":"2026-06-08T05:03:57.845Z","avatar_url":"https://github.com/ghwmelite-dotcom.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FuneralPress\n\n**The all-in-one funeral planning platform for Ghana.**\n\nFuneralPress helps families, funeral homes, and churches plan dignified funerals with modern digital tools — from brochure design to live streaming, memorial pages to budget tracking.\n\n**Live at [funeralpress.org](https://funeralpress.org)**\n\n---\n\n## Features\n\n### Design Tools\n- **Brochure Editor** — Professionally designed templates for funeral brochures, invitations, programme booklets, thank-you cards, banners, and posters\n- **One-Week Observance Cards** — Create and share traditional one-week observation cards digitally\n- **Aseda (Thanksgiving) Editor** — Design thanksgiving cloth labels\n- **Obituary Creator** — Guided step-by-step obituary writing with published pages\n- **Collage \u0026 Wreath Card Makers** — Visual tributes and memorial designs\n\n### Memorial \u0026 Sharing\n- **Memorial Pages** — Permanent online tributes with photos, stories, and shareable links\n- **Digital Guest Books** — Collect condolence messages and tributes from any device\n- **Photo Galleries** — Celebrate life through curated photo collections\n- **Live Service Streaming** — Let distant family participate in real time\n- **WhatsApp \u0026 QR Sharing** — Share designs and pages instantly\n\n### Planning Tools\n- **Budget Planner** — Track every cedi with categorized expense management\n- **Anniversary \u0026 Reminder Tracker** — Never miss a memorial date\n- **Venue Directory** — Find funeral venues across Ghana\n- **Hymn Library** — Search and browse hymns for services\n\n### Partner Program\n- **Institutional Packages** — Bulk plans for funeral homes and churches\n- **White-Label Tools** — Partners offer FuneralPress features under their own brand\n- **Referral Tracking** — Commission-based partner earnings\n- **Partner Dashboard** — Manage referrals, clients, and earnings\n\n### Admin \u0026 Operations\n- **Admin Dashboard** — Manage users, orders, partners, designs, and print orders\n- **Real-Time Notifications** — In-app + email alerts for all user activities via Resend\n- **Print Fulfillment** — Multi-region print ordering with delivery across Ghana\n- **X (Twitter) Auto-Poster** — Automated social media with cron-triggered tweet queue\n\n---\n\n## Tech Stack\n\n| Layer | Technology |\n|-------|-----------|\n| **Frontend** | React 19, Zustand, React Router 7, Tailwind CSS 3 |\n| **Backend** | Cloudflare Workers (serverless) |\n| **Database** | Cloudflare D1 (SQLite) |\n| **Storage** | Cloudflare R2 (images), KV (key-value) |\n| **AI** | Cloudflare Workers AI (Llama 3.1 — brochure writing) |\n| **Payments** | Paystack (Ghana cedis) |\n| **Auth** | Google OAuth 2.0 + JWT |\n| **Email** | Resend (transactional notifications) |\n| **Social** | X/Twitter API v2 (OAuth 1.0a auto-posting) |\n| **PDF** | React PDF Renderer |\n| **Build** | Vite, PWA (vite-plugin-pwa) |\n| **Hosting** | Cloudflare Pages |\n\n---\n\n## Project Structure\n\n```\nfuneral-press/\n├── src/\n│   ├── components/       # React components\n│   │   ├── admin/        # Admin dashboard tabs + notifications\n│   │   ├── auth/         # Login, user menu\n│   │   ├── editor/       # Brochure editor UI\n│   │   ├── landing/      # Homepage components\n│   │   ├── layout/       # Navigation, bottom nav, transitions\n│   │   ├── oneweek-editor/  # One-week observance editor\n│   │   ├── oneweek-pdf/  # One-week PDF generation\n│   │   ├── partner/      # Partner tools (WhatsApp templates)\n│   │   ├── pwa/          # PWA install prompt, progress bar\n│   │   └── ui/           # Shared UI primitives\n│   ├── pages/            # Route pages\n│   ├── stores/           # Zustand state management\n│   ├── utils/            # Helpers and default data\n│   ├── data/             # Blog posts, hymns, venues\n│   └── hooks/            # Custom React hooks\n├── workers/\n│   ├── auth-api.js       # Main API (auth, designs, payments, admin)\n│   ├── memorial-page-api.js   # Memorial pages (KV + D1)\n│   ├── live-service-api.js    # Live service pages (KV + D1)\n│   ├── share-api.js      # Brochure sharing (KV)\n│   ├── twitter-bot.js    # X auto-poster (cron + D1)\n│   └── brochure-ai-writer.js  # AI-powered content generation\n├── social-media-kit/     # 30-day tweet kit with branded images\n├── docs/                 # Plans, SEO docs, marketing\n└── public/               # Static assets\n```\n\n---\n\n## Workers (API)\n\n| Worker | Purpose | Bindings |\n|--------|---------|----------|\n| `funeralpress-auth-api` | Auth, designs, payments, admin, notifications | D1, R2, Resend |\n| `brochure-memorial-api` | Memorial page CRUD | KV, D1, Resend |\n| `brochure-live-service-api` | Live service page CRUD | KV, D1, Resend |\n| `funeralpress-share-api` | Brochure share codes | KV |\n| `funeralpress-twitter-bot` | Automated tweets (cron) | D1 |\n| `brochure-ai-writer` | AI obituary/tribute writing | Workers AI |\n\n---\n\n## Development\n\n```bash\n# Install dependencies\nnpm install\n\n# Start dev server\nnpm run dev\n\n# Build for production\nnpm run build\n\n# Deploy a worker (example)\ncd workers\nnpx wrangler deploy --config auth-api-wrangler.toml\n```\n\n### End-to-end tests (Playwright)\n\n```bash\n# First time only — install browser binaries\nnpm run test:e2e:install\n\n# Default: auto-boots wrangler dev (auth-api) + vite dev against a fresh\n# local D1. No other servers needed.\nnpm run test:e2e\n\n# Run against a Pages preview URL, staging, or any other deployment\n# (skips the local-stack auto-boot)\nE2E_BASE_URL=https://your-preview.pages.dev npm run test:e2e\n\n# Interactive UI mode for debugging\nnpm run test:e2e:ui\n```\n\nE2E lives in `e2e/`. There is **no GitHub Actions e2e workflow** — CF Free\nedge blocks GHA runner IPs. See `docs/e2e-ci.md` for the constraint and\nfuture-CI paths.\n\n---\n\n## Environment\n\n### Frontend (.env)\n```\nVITE_API_URL=https://funeralpress-auth-api.ghwmelite.workers.dev\n```\n\n### Worker Secrets (set via wrangler)\n```\nJWT_SECRET\nGOOGLE_CLIENT_ID\nPAYSTACK_SECRET_KEY\nRESEND_API_KEY\nTWITTER_API_KEY\nTWITTER_API_SECRET\nTWITTER_ACCESS_TOKEN\nTWITTER_ACCESS_TOKEN_SECRET\n```\n\n---\n\n## Pricing (Ghana Cedis)\n\n| Plan | Price | Credits |\n|------|-------|---------|\n| Single | GHS 35 | 1 design |\n| Bundle | GHS 75 | 3 designs |\n| Suite | GHS 120 | Unlimited |\n| Bulk 10 | GHS 250 | 10 designs (institutional) |\n| Bulk 25 | GHS 500 | 25 designs (institutional) |\n| Bulk 50 | GHS 800 | 50 designs (institutional) |\n\n---\n\n## License\n\nProprietary. All rights reserved.\n\n---\n\nBuilt with care for the families of Ghana.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghwmelite-dotcom%2Ffuneral-press","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fghwmelite-dotcom%2Ffuneral-press","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fghwmelite-dotcom%2Ffuneral-press/lists"}