Black box track: This hub is public; core implementation and repo detail stay partner scoped. Research status (what ships, what is spec): Research status. Technical briefings under NDA: Partners.

← Hub

Expansion Guide

How to Grow This Project

This project is designed to grow iteratively. Missing traditions, deeper sections, more images—all are welcome. Here's how to contribute while keeping our principles intact.

Current Structure

Traditions are grouped by family—not rank

  1. Abrahamic & West Asian — Islam, Christianity, Judaism, Baha'i, Zoroastrianism, Druze, Samaritan, Sufism
  2. Dharmic (South Asian) — Hinduism, Buddhism, Sikhism, Jainism
  3. East Asian — Taoism, Confucianism, Shinto, Cao Dai
  4. African & Diaspora — Yoruba, Vodou, Candomblé, Rastafari, Umbanda
  5. Other Traditions — Tengriism, Indigenous Americas, Manichaeism, Gnostic traditions, Mithraism
  6. Science & Inquiry — Science

When adding a new tradition, place it in the appropriate group—or create a new group if needed.

Adding a New Tradition

  1. Create a new page — Copy structure from islam.html or buddhism.html. Replace header nav and content with sections relevant to that tradition. Write with respect, uplift, and no comparison to diminish.
  2. Add to the hub — Add a card in index.html in the appropriate .tradition-group. Use the same format: title, brief description, 3 tags.
  3. Add to Connections — Consider whether the tradition exemplifies existing themes (compassion, sacred text, etc.) or brings something distinctive.
  4. Document images — Add a section in images/IMAGES_NEEDED.md with filenames and descriptions for generation.

Principles (Never Compromise)

  • Lift each tradition up — never diminish or rank
  • Show connections — compassion, sacred text, community, wonder
  • Respect diversity within traditions — Islam has Sunni/Shia; Christianity has Orthodox/Catholic/Protestant; Hinduism is vast
  • No proselytizing — present; don't persuade
  • Science as partner — inquiry, wonder, humility belong in the conversation
  • Images — dignified, respectful, celebratory. When in doubt, symbolic over literal.

Possible Additions (Future)

Indigenous traditions of Australia / Pacific — with extreme care and consultation with communities.

Iteration Workflow

  1. Write or expand content
  2. Add image placeholders with descriptions
  3. Generate images using IMAGES_NEEDED.md as prompts
  4. Replace placeholders in the images/ folder
  5. Review for respect and accuracy
  6. Repeat

← Back to Hub