A cultural/lunar overlay for the Red Witch calendar system.
An opt-in overlay where each user has a Moon Sign — the lunar phase on the night of their first period — and annual celebrations/observances (First Moon Night). Each moon phase maps to an archetype (e.g., Waxing Gibbous → “The Builder”), and the overlay surfaces gentle ritual suggestions, archetypal insights, and optional reminders while never altering raw cycle logs.
Onboarding (first enable)
Display
Interactions
Notifications
Accessibility & Literacy
Use 8 canonical lunar phase buckets (matches typical astrology/computation libs):
New Moon — The Seed
Quiet, inward, new beginnings. Rituals: journaling intentions, private silence. Red Witch style: “Roots night — plant a seed (literal or symbolic).”
Waxing Crescent — The Seeker
Curiosity, small steps. Rituals: list three things to try this year.
First Quarter — The Challenger
Action, decisions, momentum. Rituals: small boundary-setting exercise.
Waxing Gibbous — The Builder (example archetype for your prompt)
Refinement, focused growth, persistence. UI card text example: “Waxing Gibbous: You are a Builder. This year, tend what grew from your first Moon. Small acts repeated make structures lasting.” Ritual suggestions: light a candle and name one project to protect; a 5-minute gratitude for growth.
Full Moon — The Radiant
Culmination, visibility, celebration. Rituals: small public or private celebration.
Waning Gibbous — The Healer
Reflection, recovery, sharing. Rituals: release exercise; comfort food recipe card.
Last Quarter — The Sage
Re-evaluation, letting go. Rituals: write what no longer serves you.
Waning Crescent — The Restorer
Rest, restoration, dreamwork. Rituals: gentle breathwork, sleep intention.
Naming / Tone: give option for “mythic” vs “plain” UI copy (mythic = poetic “Builder”, plain = “Growth / Consistency”).
Moon Sign (one-time derived attribute)
moon_sign = lunar_phase_at(datetime(first_period_date), location) (phase bucket as above). Stored as overlay metadata (not altering raw logs).First Moon Night (annual recurrence)
FirstMoonNight with recurrence rule: annually on calendar date of first_period_date by default.Example UI choice during setup:
This is an example overlay configuration that plugs into your overlays system. It references core data but stores only interpretation metadata.
{
"overlay_id": "daughters_of_the_moon_v1",
"display_name": "Daughters of the Moon",
"type": "cultural",
"opt_in": true,
"version": "1.0",
"default_enabled": false,
"config_schema": {
"first_period_date": { "type": "date", "optional": true, "description": "Date of user's first period" },
"moon_sign_mode": { "type": "enum", "values": ["mythic","plain"], "default": "mythic" },
"recurrence_mode": { "type": "enum", "values": ["calendar_date", "lunar_phase"], "default": "calendar_date" },
"reminders_enabled": { "type": "boolean", "default": false }
},
"derived_attributes": {
"moon_sign": { "type": "string", "computed_by": "computeMoonSign(first_period_date, user_location)" },
"first_moon_anniversary": { "type": "date", "computed_by": "computeAnniversary(first_period_date, recurrence_mode)"}
},
"ui": {
"legend": "Shows your Moon Sign and First Moon Night. Opt-in only. Not a medical tool.",
"icon": "crescent-glyph",
"color_token": "overlay-moon-teal"
},
"disclaimer": "This overlay provides cultural and reflective content only. It does not replace medical advice."
}
Notes: overlay stores only the date(s) and computed tags; raw cycle logs remain the single source of truth elsewhere.
(Use your app’s astronomical library in production — example uses a hypothetical astro lib.)
function enableOverlay(user):
config = loadOverlayConfig(user, "daughters_of_the_moon_v1")
if not config.first_period_date:
promptUserForFirstPeriodDate()
else:
sign = computeMoonSign(config.first_period_date, user.location)
saveDerivedAttribute(user.id, "moon_sign", sign)
function computeMoonSign(date, location):
# use astronomy lib to get moon phase angle: 0-360
phaseAngle = astro.getMoonPhaseAngle(date, location)
# convert angle to bucket:
# 0: New, 0-45: WaxingCrescent, 45-90: FirstQuarter, etc. (use standard mapping)
return phaseBucketFromAngle(phaseAngle)
function computeAnniversary(first_date, mode):
if mode == "calendar_date":
return recurrence(rule="RRULE:FREQ=YEARLY;BYMONTH=month;BYMONTHDAY=day", start=first_date)
else:
# find next date each year where moon phase == original phase within +/- N days
desiredPhase = astro.getMoonPhaseAngle(first_date)
for yearOffset in 0..100:
baseline = first_date + yearOffset years
candidate = astro.findNearestDateWithPhase(baseline, desiredPhase)
schedule candidate as recurrence for that year
Important: mark lunar-phase computations as approximate and provide disclosures. Use server-side deterministic astro lib (or an established package) and compute using user.location for accuracy.
Overlay Legend (short): “Daughters of the Moon: an opt-in cultural layer. Your Moon Sign is the lunar phase on the night of your first period. The overlay suggests reflective prompts and an optional annual recurrence. Not medical.”
Modal header for Moon Sign card: “Your Moon Sign — Waxing Gibbous (The Builder)”
Card body short example: “Waxing Gibbous: You are a Builder. This sign honors steady refinement and resilience. Ritual idea: for 5 minutes today, name one thing you will protect this year.”
Risk/Compliance disclaimer (required per CO-004 & R-CO-001): “This overlay is a cultural and reflective tool, not a medical or contraceptive method. If you’re seeking medical guidance about fertility, menstruation, or contraception, consult a qualified healthcare provider.”
first_period_date, store it only in overlay metadata scope (encrypted like other sensitive health data). Do not copy to general notes without explicit consent (CO-006).Suggested privacy microcopy on save: “Your First Moon Night date is stored with the overlay and can be deleted any time. This date isn’t shared unless you explicitly share a card.”
--overlay-moon-teal: #2E9EA8 (use for glyph fills)--overlay-moon-gold: #F0C05A (for badges)Also mitigate R-CO-001 and R-CO-003 by surfacing the disclaimer prominently at onboarding and inside the overlay settings.
astral, pysolar alternatives or a deterministic in-house lib). Compute with timezone & geolocation for accuracy.overlay_meta table keyed by user_id + overlay_id. Encrypt at rest.first_period_date unless user checks a box.Provide mythic and plain versions for each phase. Example (Waxing Gibbous):
“Every daughter carries her own moon — waxing, waning, radiant, hidden — and through her phases, she remembers she is cyclic, not linear.”
The Daughters’ culture views each menstrual cycle and lunar cycle as reflections of one another. Their shared calendar honors personal beginnings (First Moon Night), collective moments of balance and rest, and archetypal festivals tied to the Moon’s major positions each year. No worship, no doctrine — just rhythm, reflection, and story.
Below are eight key observances (one for each lunar phase archetype), plus two cross-phase festivals that mark transitions and community gatherings. These can appear as optional overlay events with ritual cards or “reflection prompts.”
Timing: Nearest New Moon after the March Equinox Themes: renewal, intentions, ancestral grounding Lore: The Daughters begin their year in darkness — a time of sowing dreams, whispering wishes to the soil, and honoring those who came before. Ritual ideas:
Timing: first Waxing Crescent after Roots Night Themes: curiosity, exploration, new learning Lore: The Seekers look for what glimmers in the unknown. This observance celebrates curiosity and beginner’s courage. Ritual ideas:
Timing: first First Quarter Moon after the June Solstice Themes: boundaries, courage, decisive action Lore: The Challengers remind the sisterhood that growth requires edge. Ritual ideas:
Timing: mid-summer Waxing Gibbous Moon Themes: persistence, craftsmanship, commitment Lore: The Builders guard the works of the hands and heart. Ritual ideas:
Timing: the Full Moon nearest harvest time (late August–September) Themes: joy, visibility, self-honoring Lore: The Radiants hold festivals of light, music, and laughter. Ritual ideas:
Timing: first Waning Gibbous after Radiance Night Themes: healing, generosity, community care Lore: The Healers gather to rest and share what they have learned. Ritual ideas:
Timing: the Last Quarter before the Winter Solstice Themes: wisdom, discernment, release Lore: The Sages remind that endings feed the next beginning. Ritual ideas:
Timing: final Waning Crescent before the New Moon nearest the year’s end Themes: rest, sleep, liminality, quiet repair Lore: The Restorers guard the threshold between years. Ritual ideas:
Timing: roughly once a year, when one lunar cycle ends and the next begins Themes: endings and beginnings intertwined Lore: Sisters gather to “close the book” on the year — writing one page to release, one page to invite. Ritual idea: burn the old wish list, bury its ashes, and write a new one.
Timing: when two Full Moons fall in a single solar month (a “Blue Moon”) Themes: rare radiance, community celebration, storytelling Lore: A festival of collective brightness; Daughters share stories of their First Moon Nights, celebrating cycles of becoming. Ritual ideas:
Short reflective “Moon Prompts” that can appear throughout the year:
| Lunar Phase | Prompt Title | Short Text |
|---|---|---|
| New Moon | “Begin Again” | What seed wants planting tonight? |
| Waxing Crescent | “Small Steps” | Try something tiny but new. |
| First Quarter | “Stand Firm” | Where do you need to say no? |
| Waxing Gibbous | “Keep Building” | Patience is also creation. |
| Full Moon | “Shine” | Celebrate one visible part of you. |
| Waning Gibbous | “Give Back” | Who needs your comfort? |
| Last Quarter | “Simplify” | Let go of what’s complete. |
| Waning Crescent | “Rest” | Your stillness is sacred too. |
(menstrual cycle phases through the Daughter’s lens)
Each cycle is a miniature lunar month — four moons moving through her inner sky. They say: “The Moon moves above; we move within.”
| Physiological Phase | Lunar Phase | Archetype | Mythic Tone | Plain Tone |
|---|---|---|---|---|
| Menstrual / Bleeding | 🌑 New Moon | The Crone / The Seed | Darkness and renewal. She sheds what was; silence becomes soil. Dreams whisper from the roots. | Low energy, introspection, emotional reset; time for rest and reflection. |
| Follicular / Pre-Ovulation | 🌒 Waxing Crescent → First Quarter | The Maiden / The Seeker / The Challenger | Curiosity stirs. Light returns. She explores, plans, begins. | Rising energy, clarity, motivation to try new things and set goals. |
| Ovulatory / Fertile | 🌕 Full Moon | The Mother / The Radiant | Full bloom. Creative, expressive, outward. She offers her gifts openly. | Peak energy and sociability; good time for communication, connection, presentation. |
| Luteal / Pre-Menstrual | 🌖 Waning Gibbous → Last Quarter → Waning Crescent | The Healer / The Sage / The Restorer | Turning inward again. She discerns, heals, releases what’s complete. | Energy gradually declines; useful time for completion, reflection, boundaries, rest. |
In Daughter lore, the “outer” moon and the “inner” moon are always in conversation, but not required to match.
They teach that none are better — they simply express different creative and emotional tides.
| Inner Moon | Corresponding Season | Energetic Quality | Journal Prompt |
|---|---|---|---|
| New Moon / Menstrual | Winter | Rest, clarity, reset | “What do I release so new growth can begin?” |
| Waxing / Follicular | Spring | Growth, curiosity | “What is calling me to explore?” |
| Full / Ovulatory | Summer | Vitality, expression | “Where can I shine or share more freely?” |
| Waning / Luteal | Autumn | Reflection, refinement | “What needs completion before I rest?” |
If you include this lore in Daughters of the Moon: