🌌 Celestfall

"When the firmament fractures, the seven seals shall speak. Align the stars, weave the ancient glyphs, and unlock the celestial prophecy."

---

📖 Table of Contents

• Lorebook & Mythos
• The Seven Prophecies
• Key Features
• Technical Architecture & Stack
• Project Structure
• Getting Started
• Ritual Mechanics & API
• License & Acknowledgments

---

📜 Lorebook & Mythos

In the age before the shattered sky, the celestial vault stood in absolute equilibrium. Guided by the Aetherial Compact, seven cosmic forces maintained the barrier between mortal perception and the void beyond.

When the Celestfall Event shattered the firmament, the cosmic balance dissolved, leaving behind seven divine fragments hidden within ancient, lock-and-key seal mechanisms. Known as the Prophecy Seals, these fragments contain the memories, power, and final decree of the sky-weavers.

To unlock the secrets of Celestfall, a seeker must navigate through the interactive ritual engine, decypher ancient runic scripts, manipulate celestial orbits, and cast spells using pure algorithmic resonance.

"Only those who command both code and cosmic harmony may pierce the Veil."

---

🔮 The Seven Prophecies

Each puzzle within Celestfall corresponds to a specific chapter in the Celestial Codex. Seekers must resolve each ritual in sequence to unbind the final seal.

#	Prophecy Title	Ritual Type	Core Mechanic
I	Sigil of Awakening	Glyph Decipherment	Pattern Recognition & Dynamic Node Tracing
II	Celestial Alignment	Astronomical Orbit	Harmonic Phase Shifts & Orbital Locking
III	Blood Moon Conduit	Crimson Ritual Engine	Mana Flow Routing & Frequency Tuning
IV	Whisper of Void	Acoustic Resonance	Dynamic Audio Synthesis & Spectral Matching
V	Astronomic Weaver	Constellation Matrix	Multi-node Graph Solvers & Parallax Spatial Math
VI	Shattered Mirror	Dimensional Reflection	Depth-map Parallax Shaders & Refraction Alignment
VII	The Celestfall Seal	Master Conjunction	Multi-stage Spell Casting & Final Unsealing Ritual

---

🏛 Lore Entries & Puzzle Mechanics

I. Sigil of Awakening

• Lore: The first breath of the celestial awakening. Long buried beneath cosmic dust, the initial seal requires the seeker to trace the foundational rune of the First Weaver.
• Mechanic: Dynamic web-canvas gesture solver requiring precise node connections without breaking the visual circuit line.

II. Celestial Alignment

• Lore: "As above, so below." The twin moons and planetary rings must align along the solstice meridian to channel pure aetheric energy.
• Mechanic: Interactive 2D canvas orbital system requiring phase-shifting slider controls to sync velocity, angle, and gravitational pulls.

III. Blood Moon Conduit

• Lore: The crimson eclipse drains power from idle nodes. Only by balancing the crimson flow through hidden conduits can the central altar receive power.
• Mechanic: Flow-based puzzle engine using graph routing logic where energy vectors must reach equilibrium.

IV. Whisper of Void

• Lore: The void speaks in frequencies unheard by common ears. Harmonic resonance must be matched to dispel the void mist.
• Mechanic: Audio visualizer and waveform-matching mechanism where players adjust frequency parameters to cancel out visual distortion waves.

V. Astronomic Weaver

• Lore: Unbound stars scatter across the night. By connecting the sacred stars, the true constellation map reveals the path forward.
• Mechanic: Dynamic graph traversal puzzle using distance algorithms and spatial coordinate locks.

VI. Shattered Mirror

• Lore: Reality splits into layered reflections. Looking past the surface requires seeing through multiple planes of spatial depth.
• Mechanic: Mouse/touch parallax engine driving 2D perspective shaders to align fragmented images into a single cohesive glyph.

VII. The Celestfall Seal

• Lore: The culmination of all six prior rituals. The grand altar activates, demanding a full sequence spell-casting combination.
• Mechanic: Master state machine combining keypress sequences, timed inputs, and real-time canvas feedback to complete the final unsealing sequence.

---

✨ Key Features

• Gothic-Cyber Aesthetic: High-contrast UI featuring neon pinks, royalty red accents, gothic typography, and dark-mode immersive elements.
• Interactive Ritual Engine: Fully custom JavaScript event-handling framework designed specifically for real-time spell input and state changes.
• Responsive Visual FX: Smooth dynamic animations, particle systems, and canvas canvas-layering for spellcasting effects.
• Lore-Integrated Puzzles: Every puzzle feeds directly into the narrative, providing an immersive story arc as you progress through the seven prophecies.
• Modular Puzzle Architecture: Built with clean, decoupled JavaScript modules making it simple to add, tweak, or expand puzzle stages.

---

🛠 Technical Architecture & Stack

• Front-End: Modern Vanilla JavaScript (ES6+), HTML5, Canvas API, CSS3 (Custom Variables, CSS Grid/Flexbox).
• Animation & FX: GSAP / Web Animations API / Custom Canvas Render Loop.
• Audio Engine: Web Audio API for ritual feedback, harmonic soundscapes, and sound FX.
• State Management: Custom Event Bus & Session-persisted Ritual State Engine.