Skip to content

wellswei/MythicalHelper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

MythicalHelper

MythicalHelper social preview

MythicalHelper is a free, open-source, nonprofit website centered on a printable, verifiable certificate for parents who want to preserve childhood wonder with care.

A certificate for the day children ask who carried the magic.

The core idea is simple: when a child grows old enough to hear that Santa Claus, the Tooth Fairy, or other childhood legends were "just made up," they can discover a certificate and verification page showing that their parents were acting as trusted helpers on behalf of that larger world.

Live Project

Why This Exists

MythicalHelper exists to give visible form to a kind of care that usually stays hidden.

Many parents spend years carrying out gifts, traditions, and small works of wonder by hand. This project treats that effort not as a throwaway trick, but as a real act of stewardship. Its goal is to help families keep that effort legible, so that when the right moment comes, a child can understand that wonder was not erased by human hands. It was carried forward through them.

Product

The project is organized around a certificate flow and a small passive-discovery surface:

  • a public homepage
  • an access page
  • a certificate page with PDF export
  • a public verification page
  • parent guide pages for search discovery
  • a share page with reusable copy for people who want to pass the project along
  • about and privacy pages for trust, open-source context, and data clarity

Repository

MythicalHelper/
├── access/                # Access flow
├── certificate/           # Certificate page
├── guides/                # Parent-facing guide pages
├── about/                 # Project context
├── privacy/               # Privacy notes
├── share/                 # Reusable share copy
├── verify/                # Public verification page
├── worker/                # Cloudflare Worker + D1 backend
├── styles/                # Shared site styles
├── index.html             # Homepage
├── package.json           # Local dev scripts
└── logo.png               # Project logo

Active Pages

Runtime

The active flow has a lightweight backend shape:

  • the access page can create, retrieve, edit, and delete a record through /api
  • the certificate page can read a record through an access token or session
  • the verification page can read a public record through a verify token
  • the certificate page exports the result as a browser-side PDF

Current auth behavior:

  • Sign Up creates a record and establishes a session
  • Sign In sends a magic link
  • opening that magic link restores an editable session
  • Access automatically becomes edit mode while a session is active

Development

Install dependencies:

npm install

Run the frontend:

npm run dev:static

Run the Worker locally in a second terminal:

npm run dev:worker

Apply the local D1 schema before testing the API:

npm run db:migrate:local

During local development:

  • the static frontend runs on http://localhost:8000
  • the Worker API runs on http://localhost:8787
  • the frontend will automatically use http://localhost:8787/api when opened from a local static server

Deployment

The project is deployed as:

  • Cloudflare Pages for the website
  • Cloudflare Workers + D1 for the API
  • Zoho for outbound magic-link email

Production domains:

  • https://mythicalhelper.org
  • https://www.mythicalhelper.org
  • https://api.mythicalhelper.org

Before deploying the Worker:

To enable Zoho sending in the Worker, configure:

  • EMAIL_MODE=zoho
  • APP_ORIGIN
  • ZOHO_EMAIL
  • ZOHO_CLIENT_ID
  • ZOHO_CLIENT_SECRET
  • ZOHO_REFRESH_TOKEN
  • optional: ZOHO_ACCOUNT_ID

How To Help

The most useful contributions right now are:

  • copy and narrative refinements that feel warmer, clearer, and more believable
  • mobile layout and accessibility improvements
  • authentication, session, and magic-link polish
  • Zoho and email delivery reliability improvements
  • multilingual support
  • new realm ideas that still fit mainstream childhood folklore and family ritual
  • additional parent guides for gentle search discovery

If you want to contribute, start small and stay close to the current certificate-first product shape.

Repository Topics

Recommended GitHub topics:

open-source
nonprofit
parenting
christmas
santa
tooth-fairy
printable
certificate
cloudflare-workers
cloudflare-d1

Open Source

License

MIT License.