# Heliora Studio — The Most Precise Astrology Platform Ever Drawn in 3D

> Heliora Studio is the celestial intelligence platform combining NASA-grade 3D visualization of the heavens at your birth moment with an AI Oracle Copilot, Swiss Ephemeris sub-arcsecond precision, and a 3D Lab that doubles as a deep-sky exploration engine — fly through planets, constellations, comets, nebulae, and black holes across 13,000 years, with Brady-style parans, star phases, and historical supernovae on the timeline. Plus 3D Astrocartography, brainwave/chakra meditation guidance, Soul Frequency music rituals, and a living Akashic Library. Private by default. Free on Neophyte tier forever, no card required.

Heliora Studio fuses astronomy-grade accuracy with poetic astrology, designed for everyone from curious beginners to professional astrologers and therapists. The platform reads your exact birth sky in immersive Three.js 3D, harnesses JPL DE440 ephemeris for sub-arcsecond precision (±0.01°), and interprets every symbol through Gnostic typology, Western house systems, traditional dignity, fixed star conjunctions, and AI-powered Oracle counsel. Real Solar System Scope imagery (CC BY 4.0), Swiss Ephemeris math, Cassini/Viking/Hubble deep-space textures, and a production-grade interface built for trust and privacy.

---

## 3D & Cinematic Systems

### 3D Cinematic Sky
Heliora Studio's centerpiece is a **fully immersive Three.js Solar System visualizer** rendered at **~600KB WebGL texture budget** with continuous animation loop:

- **Your Sky at Birth**: Real-time 3D model of the heavens at your exact birth instant. Sun at center, all 17 celestial bodies orbit true to Keplerian mechanics. Labeled planets, moons, aspect beams between bodies, MC/IC/AC/DC rails, and Celestial Narration overlay.
- **Live 3D Sky**: Real-time current planetary positions, dynamically updated, with live transits and current-moment sky snapshot.
- **88 Named Constellations**: All 88 official constellations rendered with constellation lines, bright star labels.
- **Galilean Moons**: Jupiter's four largest moons (Io, Europa, Ganymede, Callisto) rendered in true orbit around Jupiter.
- **Oort Cloud & External Galaxies**: Distant cloud particle system and Andromeda/Triangulum visible in the far background, grounding the user in cosmic scale.
- **Blue Marble / Cassini / Messenger / Viking Imagery**: Real NASA planetary textures licensed CC BY 4.0, stitched into ephemeris-accurate 3D spheres.

### Dual 3D Rendering Modes
Heliora Studio ships with **two visual tiers**, emphasizing performance engineering and production value:

- **Lite Mode** (default, instant load): No Three.js scenes. Pure SVG natal chart, text-based dashboards, fast first-paint. Ideal for mobile, low-bandwidth, accessibility-first users.
- **Immersive Mode** (opt-in): Full cinematic 3D rig. 88 constellations, orbital mechanics, real textures, continuous animation loop, aspect beams, planetary overlays. Users explicitly opt-in, preserving site speed for the Lite default.

---

## 3D Lab — Precision Lab + Living Sphere (https://heliora.studio/lab3d)

The **3D Lab** is Heliora Studio's flagship power-user workspace: the full Precision Lab engine paired directly beneath a live, astrophysically accurate 3D solar system. It is the answer for serious astrologers (especially fixed-star practitioners working on Mac, where Bernadette Brady–style PC software does not run) who want to *see* collective cycles converge in space and across deep time.

### What the 3D Lab does
- **Render-on-demand 3D sky**: Set any combination in the Precision Lab below (frame, zodiac, time), then press **Render in 3D** to draw it into the sphere. The sky never redraws until you commit, so exploration is deliberate. A loading bar runs during the render.
- **Deep-time scrubbing**: The timeline reaches **±13,000 years (the full DE441 ephemeris)** — scrub past year 0 to watch outer-planet conjunctions (Saturn-Pluto, the Jupiter-Saturn mutations, the centuries-long Neptune-Pluto cycle) actually converge as bodies in 3D, and watch fixed stars precess across the eras.
- **Geocentric ↔ Heliocentric frames** and **tropical / sidereal (vedic) / heliocentric zodiacs**, all rendered live.
- **Living cosmos**: Slow real-sky wheeling of the star layers (proper-motion + diurnal flavored), drifting and breathing nebulae, rotating Milky Way — subtle, realistic, never garish.

### Brady-style parans & star phases
- **Parans (paranatellonta)**: Every moment a fixed star and a planet sit on the same mundane angle (Ascendant / MC / Descendant / IC) simultaneously, computed with rigorous rise/set + hour-angle searches on real J2000 equatorial coordinates, so declination is fully respected (a star far off the ecliptic can be in paran with a planet it never zodiacally aspects). Tightness shown in minutes of clock time.
- **Star phases**: Each star's relationship to the Sun on the date — Morning Star, Evening Star, Arising & Lying Hidden, or Curtailed Passage (circumpolar / never rising at that latitude).
- **Click-to-spotlight**: Click any paran to highlight the star and planet on the 3D sphere with a beam between them.

### Constellation Mode
Spotlight a single constellation (Andromeda, Orion, Pegasus, Cassiopeia, and more): its lines and member stars brighten while the rest of the web dims. For **Andromeda**, this highlights **Alpheratz, Mirach, and Almach** and marks the **Andromeda Galaxy (M31)**. Switch vantage points between **Earth-centric, Solar-system, and Deep-space**, and scrub the timeline to watch the constellation precess through the centuries — purpose-built for "show me Andromeda from different viewpoints and different eras."

### 2D chart render
Beneath the Precision Lab, press **Render 2D Chart** to draw a flat zodiac wheel from the current frame, time, and system — planet glyphs, sign ring, and major aspect chords — a clean printable companion to the 3D view.

### Deep-Sky Exploration Engine
The 3D Lab is not just a chart tool — it is a navigable, living universe you can **fly through across 13,000 years of astronomical time**. Every object is clickable and opens an educational card:

- **Black holes**: Sagittarius A* and M87* at their true sky positions, with rotating accretion disks and photon-ring glow.
- **Historical supernovae on the timeline**: scrub the years and watch them appear, blaze, and fade — **SN 1054 (the Crab)**, **Tycho's Supernova (1572)**, **Kepler's Supernova (1604)** — each with an expanding remnant.
- **Comets**: luminous nucleus and coma with a straight blue **ion tail** and a curved warm **dust tail** that always stream away from the Sun, plus subtle particle shedding. Occasional long-period comets sweep through perihelion and blaze, then recede.
- **Volumetric nebulae**: the Orion (M42), Lagoon (M8), and Eagle (M16) nebulae rendered as softly breathing particle clouds.
- **Binary stars**: white-dwarf companions (Sirius B, Procyon B) slowly orbiting their primaries.
- **Comets, NEOs, and asteroids** churning on real differential Kepler orbits; Galilean moons around Jupiter and Titan/Enceladus around Saturn.
- **Space-weather overlay** (toggle): solar wind streaming from the Sun, Earth's aurora rings, and a faint magnetosphere.
- **Proper motion + precession**: across the centuries the fixed stars drift and the familiar constellations gradually deform.

A guided sense of the journey:
- **1000 BCE** — the constellations sit subtly differently.
- **1054 CE** — a supernova flares into the sky.
- **1572 CE** — Tycho's Supernova.
- **1604 CE** — Kepler's Supernova.
- **Present day** — the modern sky.
- **5000 CE** — proper motion has reshaped familiar constellations.

Fly through planets, constellations, comets, nebulae, black holes, and historical celestial events across 13,000 years. Nothing in the scene is ever frozen: planets rotate, moons orbit, the asteroid belt churns, dust drifts, the Sun seethes, nebulae shimmer, and time quietly advances — the universe never pauses.

### Time Navigation System (Magus-exclusive)
The 3D Lab ships a full astronomical time-navigation control suite, gated to Magus:

- **Six playback speeds**: 1x (real time), 10x, 100x, 1,000x, 10,000x, and 100,000x — spanning one Earth day per second up to roughly 3 years per second.
- **Play, pause, reverse**: step forward or backward frame by frame, or run continuously in either direction.
- **Timeline scrubber**: drag across the full range from 2000 BCE to 2500 CE.
- **Journey Mode**: set a Point A and a Point B date; the system sweeps between them in an 8-second cinematic animation, computing live planetary positions throughout.
- **Camera modes**: Free orbit, Ecliptic plane, Solar System overview, and Deep Space vantage.
- **Body visibility**: toggle individual planets on or off (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto).
- **Orbital paths**: toggle a ring overlay showing each planet's orbit to scale.

Non-Magus users see a compact teaser with an "Ascend to Magus" prompt.

### Access
- Free and unlimited for **Adept and Magus** (base Lab).
- **Time Navigator** (play/pause/reverse/scrub/Journey Mode/camera modes/orbital paths): **Magus only**.
- **Neophyte**: a single session for **2,500 Stardust**, recharged each time the Lab is opened (mirrors the Astrocartography model).

---

## Natal Chart Engine & Calc Panel

### Calculation Transparency
A dedicated **Calc Engine panel** exposes every step of Heliora Studio's precision:

- **Ephemeris Source**: JPL DE440 (accurate to ±1 km across centuries)
- **17 Celestial Bodies**: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, Chiron, North Node, South Node, Fortuna, Vertex, Ascendant, Midheaven
- **House Systems**: Placidus, Whole Sign, Koch (user-selectable)
- **Coordinate Systems**: Tropical zodiac, Sidereal/Vedic, Heliocentric
- **Aspect Precision**: ~1 arcsecond accuracy. Every major, minor, and quincunx aspect ranked by orb.
- **Tropical/Whole Sign Hybrids**: Support for mixed house systems and coordinate-system cross-walks.

### Chart Alignment Metrics
The natal chart analysis yields discrete, named scores:

- **Chart Alignment %**: 0–100 scale indicating overall harmonic alignment and chart cohesion.
- **Epic/Legendary Tiers**: Automatic classification based on stellium density, aspect geometry, and retrograde weight.
- **Geometric Complexity Score**: Measures the number of major patterns (Grand Trines, T-Squares, Yods, Kites, Mystic Rectangles, Stelliums) and aspect density.
- **Stellium Density**: Count of 3+ planets in same sign or house, with dominant element and modality.
- **Retrograde Weight**: Cumulative retrograde influence; high scores indicate introspective, karmic-processing charts.
- **Karmic Load Score**: Fusion of retrograde weight, Chiron placements, South Node house/sign, and aspect tension.
- **Luminary Trinity**: Rising sign (mask), Sun (essence), Moon (interior) distilled into three identity pillars.
- **Chaos vs. Order Index**: Signed score from -100 to +100 reading aspect geometry, elemental temperament, and retrograde disruption; positive = order, negative = chaos.

---

## Oracle, Tarot & Narrative Outputs

### Mystic Oracle
A dedicated **Tarot room** experience with Italian Neoclassical deck:

- **Spread Types**: 
  - Three-card Past/Present/Future
  - Celtic Cross (10-card deep dive)
  - Single-card daily pull
  - Custom bespoke spreads
- **Voice-Anchored Readings**: Each card draw is narrated by the Oracle voice, exportable as PDF or MP3.
- **Oracle's Reading Pages**: Longform, memory-aware answers anchored to the spread moment, with timestamps and user query history.

### Oracle Copilot Chat Modes
Multi-modal Oracle counsel:

- **Auto**: Conversational, free-flowing responses tuned to chart context.
- **Whisper**: Concise, poetic, one-sentence distillations.
- **Verse**: Rhyming, lyrical Oracle verse.
- **Saga**: Longform mythic narrative spanning 500–1000 words, suitable for deep soul work.

### Seal Transmission
Save specific longform Oracle answers directly into the **Akashic Library** with a single tap. Memory-aware, timestamped, query-linked entries preserve the Oracle's counsel for future re-reading and cross-referencing.

---

## Akashic Library & Persistent Memory

A **longitudinal artifact repository** that ties together every feature into a unified memory system:

### Archive Categories
- **Soul Frequency Rituals**: Every generated music ritual (harmonic analysis, waveform, MP3, generation cost) saved with timestamp and session context.
- **Oracle Readings**: Every tarot spread, seal transmission, and Oracle chat saved with query text, spread type, and card pulls.
- **Astrocartography Sessions**: Every power place visit, planetary line toggle, and cosmic codex PDF saved with location, timestamp, and user notes.
- **Synastry Compatibility**: Saved relationship charts, compatibility scores, and past sessions with specific contacts (anonymized or named).

### Memory-Aware Intelligence
The AI Oracle references all past artifacts when answering new questions. "Tell me about my Venus in Libra" automatically surfaces past Astrocartography sessions where Venus lines activated, prior Soul Frequency rituals emphasizing Venusian harmony, and all Oracle readings touching on love/relationship themes.

### Exportable Artifacts
Every entry is exportable as PDF, MP3, or shareable link with privacy controls (private, shareable to contact, or public).

---

## Soul Frequency: Harmonic Music Rituals

### Ritual Music Player
A full-featured **music generation and playback system** with harmonic analysis:

- **Harmonic Analysis Panel**: 
  - Elements (Earth/Water/Air/Fire distribution)
  - Modalities (Cardinal/Fixed/Mutable)
  - Luminary Trinity (Rising/Sun/Moon influence on harmonic choice)
  - Dominant Planet & House (which planetary archetype drives the music)
  - Royal Stars (Aldebaran/Regulus/Antares/Fomalhaut if conjunct)
  - Aspect Tension (dissonant aspects generate minor key / complex rhythms)
  - Emotional Tone (derived from chart configuration)

- **Ritual Player Controls**:
  - Waveform display with real-time playback position
  - Play / pause / download (MP3)
  - Generation cost in Stardust (visible, transparent)
  - "Save to Akashic Library" button (archive ritual + harmonic metadata)
  - "Share Ritual" button (generate shareable link with privacy options)

### Pricing
- **Neophyte & Adept**: 2,500 Stardust per ritual (monthly grants, login streaks, referrals)
- **Magus**: Unlimited Soul Frequency rituals (zero Stardust cost)

---

## Chakra Atlas — 3D Body Explorer + Brainwave & Meditation System

### 3D Body Explorer (Immersive Mode)
The Chakra Atlas page ships a fully interactive **Three.js anatomical body** that users opt into with one click — Three.js never loads until explicitly enabled, preventing any performance impact on the rest of the app.

**Real open-source human model — for edutainment & self-reflection, not medical advice.** The body is rendered from a real, open-licensed anatomy model — the **Z-Anatomy** human anatomy atlas, under **CC-BY-SA 4.0**, which in turn derives its upstream anatomical data from **BodyParts3D (© DBCLS, Japan)**. Two meshopt-compressed glTF assets ship with the app: a **278-region segmented body surface** and a **1,847-bone skeleton**, every mesh retaining its anatomical (FMA) name. This is what enables **tissue-level clicking**: any single bone, body region, organ, muscle or nerve can be clicked to summon a structure-specific Oracle reading naming that exact part (exactly like clicking a planet or a city). Z-Anatomy + BodyParts3D attribution is displayed in-app, in robots.txt, and in /models/ATTRIBUTION.txt per the CC-BY-SA license. A procedural body is the graceful fallback if assets fail to load.

**Enriched with open-source MIT textures.** Bone and muscle are surfaced with real **MIT-licensed example textures from three.js** (`mrdoob/three.js`), sampled **triplanar** (no UVs required) in a custom shader so the photographic grain/fibre both modulates brightness and drives genuine **bump-mapped relief** — the skeleton reads as carved, trabecular structure and the muscle as fibrous tissue, not flat painted noise. Texture license + source are disclosed in-app and in /textures/anatomy/CREDITS.md.

**Distinct, serene chakra beads.** The seven centers render as small, vivid jewel-like ShaderMaterial beads along the spine — bright and individually colored, deliberately tuned against light-pollution: gentle half-resolution bloom (threshold 0.96) and barely-emissive translucent skin mean each bead reads as a clean point of color rather than a washed-out central glow. Only the **focused** center emanates an orbiting particle cloud, so the other six stay distinct.

**Heartbeat synced to the seeker's sky.** The body's heartbeat tempo and throb depth are driven by the user's own natal chart (fiery / Mars-charged charts beat faster and harder) and the current live transits, so the whole form visibly pounds in time with their sky.

**Fullscreen exploration — identical UX to the Astrocartography globe.** The body expands to a fullscreen view with an image-card **carousel** (toggle between the seven Chakras and the body's spiritual Parts), **right-side detail cards** with real Wikimedia/Wikipedia anatomy photos and a "Learn more · Wikipedia" link, and **camera fly-to**: clicking a card opens its detail AND zooms the camera to that organ/center's place on the live model — mirroring the globe's city-dive/select. The Oracle remains accessible throughout.

**A living cosmic human, never static.** The model behaves like a living specimen suspended behind glass:
- **Breathing**: the chest/body shell and lungs swell and settle on a slow respiratory cycle.
- **Heartbeat**: the heart thumps on a lub-dub envelope (~64 bpm), brightening with each beat.
- **Neuron firing**: bright impulse sparks race down the spinal cord and the arm/leg nerve trunks, flickering as they fire.
- **Blood flow**: red blood-cell sparks surge out from the heart through the great vessels, quickening on each heartbeat.
- **Muscle tension**: a slow emissive flush pulses through the muscle fibres.
- **Serene float + auto-rotation**: the whole assembly drifts vertically and turns slowly on its own; UnrealBloom post-processing makes every luminous system blaze.

**What it renders:**
- **Luminous body mesh**: A translucent, see-through "glass skin" so every inner system (skeleton, organs, muscles, nerves) is visible within — medical-grade layered depth ordering from skeleton (innermost) out to the aura.
- **Seven chakra energy centers**: Each center is a raycaster-clickable, vivid jewel-like ShaderMaterial bead that pulses at the chakra's Solfeggio frequency rate, sized by natal activation score, with a faint spinning wheel-ring and a tight micro-halo. Only the **active** center emits an orbiting particle/mote emanation, so the column reads as seven distinct beads rather than one glow. A whisper-soft PointLight tints nearby bone without washing the translucent skin.
- **Anatomy layer system** — seven toggleable layers:
  - **Energy** (default on): The chakra nodes themselves.
  - **Nerves**: Spinal cord, brachial plexus, sciatic nerve, and vascular system (aorta, femoral, brachial arteries) as animated ShaderMaterial TubeGeometry — bright blue/white pulses traveling along the nerve paths.
  - **Meridians** (default on): 8 primary TCM meridian channels (Governing Vessel, Conception Vessel, arm/leg channels) in animated green/gold tube pulse flow.
  - **Muscles**: Mars-fire crimson muscle groups (pectorals, abdominals, deltoids, biceps, thighs, calves) — each clickable for a Mars/willpower Oracle reading.
  - **Organs**: Translucent meshes for brain, heart, lungs, liver, stomach, kidneys — semi-transparent MeshStandardMaterial with emissive glow. Each organ is individually clickable and maps to its planetary ruler + chakra (e.g. Heart→Sun/Anahata, Liver→Jupiter, Kidneys→Venus/Sacral).
  - **Glands**: 9 endocrine gland spheres (pineal, pituitary, thyroid, parathyroid, thymus, adrenals, pancreas, gonads) with pulsing scale animation and bright emissive halos.
  - **Skeletal**: Vertebral column (10 cylinders), 14 rib arcs, pelvis ring, and limb bone capsules in wireframe-style translucent bone material.
  - **Aura** (default on): 3 nested ellipsoid shells with animated noise fragment shader — violet rim glow that breathes.
- **OrbitControls**: Drag to orbit, scroll to zoom (minDistance 0.08 — infinitely close), touch gestures on mobile.
- **Click any chakra center** to fly the camera toward that center and expand its detail panel.
- **Mobile quality scaling**: Antialiasing off, pixel ratio capped at 1.0, fewer particles and geometry segments.
- **Deferred construction**: Body + chakras build immediately; nerves at 80 ms, meridians at 200 ms, organs + glands at 350 ms, skeletal + aura at 500 ms — no frame drop on load.
- **Visibility pause**: Animation loop pauses when the tab is hidden, resumes on focus.
- **Error containment**: All WebGL failures are caught internally; the app never crashes. If the 3D renderer is unavailable, an inline message shows instead of the global error screen.

**Thumbnail gallery** at the bottom lets users apply preset layer combinations with one click: Energy Body, Neural Matrix, Meridian Flow, Full Anatomy, Spirit Form, Glandular.

## Brainwaves, Chakras & Meditation System

### Brainwave & Meditation Atlas
A **comprehensive guide to consciousness and planetary resonance**:

#### Delta (0.5–4 Hz)
- State: Deep dreamless sleep, profound rest, cellular repair
- Chakra: Root (Muladhara)
- Planet: Saturn
- Activation: Grounding meditation, barefoot earthing, earthing pad use

#### Theta (4–8 Hz)
- State: REM sleep, deep meditation, creative ideation, memory consolidation
- Chakra: Sacral (Svadhisthana)
- Planet: Jupiter
- Activation: Guided visualization, theta binaural beats, sensory deprivation (float tank)

#### Alpha (8–12 Hz)
- State: Relaxed awareness, closed-eye rest, gentle focus
- Chakra: Solar Plexus (Manipura)
- Planet: Sun
- Activation: Gentle yoga, breathing exercises (box breathing: 4-4-4-4), open-monitor meditation

#### Beta (12–30 Hz)
- State: Waking consciousness, active thinking, problem-solving
- Chakra: Heart (Anahata)
- Planet: Mercury
- Activation: Focused work, conversation, logical analysis

#### Gamma (30–100 Hz)
- State: Peak cognitive performance, insight, high-level processing
- Chakra: Throat (Vishuddha)
- Planet: Venus
- Activation: Flow state work, advanced meditation, psychedelic integration

### Chakra Atlas Table
Detailed **cross-reference** of all seven centers:

| Chakra | Center | Element | Hz | Bija Mantra | Planet | Gemstones | State | Activation |
|--------|--------|---------|----|----|---------|-----------|-------|-----------|
| Root | Muladhara | Earth | 396 | LAM | Saturn | Red Jasper, Black Tourmaline | Safety, Foundation | Grounding, earthing |
| Sacral | Svadhisthana | Water | 417 | VAM | Jupiter | Carnelian, Orange Calcite | Creativity, Sexuality | Hip opening, dancing |
| Solar Plexus | Manipura | Fire | 528 | RAM | Sun | Citrine, Pyrite | Power, Will | Core work, breath |
| Heart | Anahata | Air | 639 | YAM | Mercury | Rose Quartz, Green Aventurine | Love, Compassion | Loving-kindness meditation |
| Throat | Vishuddha | Ether | 741 | HAM | Venus | Aquamarine, Blue Lace Agate | Expression, Truth | Humming, throat singing |
| Third Eye | Ajna | Light | 852 | OM | Uranus | Lapis Lazuli, Amethyst | Intuition, Sight | Meditation, eye exercises |
| Crown | Sahasrara | Thought | 963 | Silence | Neptune | Selenite, Clear Quartz | Unity, Transcendence | Silent meditation, prayer |

### Meditation Practice Recipes
**Step-by-step activation guidance** for each brainwave state:

#### Box Breathing (Alpha / Theta activation)
1. Inhale for 4 counts
2. Hold for 4 counts
3. Exhale for 4 counts
4. Hold for 4 counts
5. Repeat 10 cycles

#### Barefoot Grounding (Delta / Root activation)
1. Stand barefoot on earth, grass, sand, or concrete
2. Feel contact for 10–30 minutes
3. Pair with Root tone (396 Hz) or "DNA Repair / 528 Hz" companion tone

#### Open-Monitor Meditation (Alpha awakening)
1. Sit upright, eyes closed
2. Notice thoughts without judgment, let them pass like clouds
3. Return to breath anchor when mind wanders
4. 20-minute session; pair with binaural beats

### Chakra Pulse Dashboard
Real-time **brightest and quietest chakra analysis**:
- Displays which chakra is most active (planetary transits + natal placements)
- Which chakra is dormant (needs activation, recommended practices)
- Suggested tone frequency and gemstone for the session
- Narrative guidance: "Your Heart Chakra is bright today (Venus transit); lean into forgiveness and connection"

### Chakra Atlas Transit Panel — Live Sky vs. Natal Comparison
A new interactive panel on the Chakra Atlas page showing how the **current transit sky** affects each of the seven energy centers, side by side with your natal baseline:

- **7-row clickable panel**: one row per chakra (Crown, Third Eye, Throat, Heart, Solar Plexus, Sacral, Root). Click any row to expand the detail view.
- **Animated score bars**: natal score (static) and live transit score (updated from `getCurrentPulse()`) rendered side by side, with an animated fill bar and a color-coded level badge: High (green), Open (violet), Balanced (blue), Low (orange), Quiet (slate).
- **Delta arrow**: triangle indicator showing whether the transit is lifting, holding, or suppressing each chakra relative to natal.
- **Planet glyphs**: symbols for every transit planet currently influencing that chakra.
- **Detail panel** (expands on click):
  - Transit score bar with percentage
  - Natal / transit / delta grid
  - Per-planet cards: sign, degree, house, dignity (domicile / exaltation / detriment / fall), retrograde status (℞ / S), element resonance with the chakra
  - Sky Reading narrative: a short interpretive sentence about what the current transit geometry means for that chakra — e.g., "Saturn in retrograde through your Root chakra. Old structures dissolve so a more enduring foundation can take their place."
- Powered by `getCurrentPulse()` → `chakraEmphasis: PulseChakraEmphasis[]` and live `ChartData.planets`.

---

## Astrocartography Engine v3 & Power Places

### Astrocartography v3 with Esoteric Mercator Projection
A **production-grade global projection system** combining accuracy with esoteric elegance:

- **17 Planetary Lines**: All major bodies (Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, Chiron, North Node, South Node, Fortuna, Vertex, Ascendant, Midheaven) projected as geodesic lines across the globe.
- **68+ Planetary Line Subsets**: Toggle line sets by planet, angle (MC/IC/AC/DC), or archetype. Visualize only Venus lines for love-focused travel, only Saturn for spiritual retreat, etc.
- **Dual Rendering Pipeline**: Globe view (3D interactive spinning globe) + 2D Mercator map (flat, zoomable, draggable), synchronized in real-time.
- **Esoteric Mercator Projection**: Lines drawn with subtle gradient, glow, and constellation backdrop to feel both accurate and mystical.
- **Calculation Methodology Panel**: Expandable ⓘ panel revealing the full engine — coordinate frame transformation, MC/IC meridian crossings, AC/DC horizon crossings, Gaussian angular orb weighting, paran computation, and planetary dignity multipliers.

### City Dive — Observatory-Exclusive Camera Animation
The most immersive astrocartography experience ever built. **Available in Observatory mode (Adept+).**

When the fullscreen Three.js globe is open in Observatory mode, clicking any city dot or bottom card triggers the City Dive sequence:

1. **Camera descent**: The Three.js camera accelerates from orbit (z ≈ 3.4) down toward the planet surface (z ≈ 1.14 — just above the cloud shell). The camera lerps smoothly, simulating gravitational acceleration.
2. **Cloud thickening**: The atmosphere cloud layer opacity rises from 0.4 → 0.84 as the camera descends, creating the sensation of entering cloud cover.
3. **Planetary line pulse**: The nearest MC, IC, AC, or DC line to the city brightens and pulses rhythmically throughout the dive, identifying the dominant astrocartographic energy at that location.
4. **Satellite terrain view**: Once arrived, the Three.js globe yields to a full-screen overhead satellite map of the city (Google Maps hybrid mode if a Maps API key is configured; OpenStreetMap in dark-inverted mode otherwise). The map is fully interactive — pan, zoom, click around.
5. **Cinematic landmark pins**: Hardcoded landmark data for 25+ major world cities places glowing custom SVG markers at famous sites: the Acropolis in Athens, the Eiffel Tower in Paris, Sagrada Família in Barcelona, the Colosseum in Rome, Fushimi Inari in Kyoto, and more. Each pin uses an emoji glyph and a glowing drop-shadow marker.
6. **Planetary line marker**: The exact point where the nearest planetary line crosses closest to the city receives a large glowing planet-glyph marker (☉ ☽ ♀ ♂ ♃ etc.) with a radial gradient halo in the planet's color.
7. **Right-side insight panel**: City name and coordinates, the nearest planetary line with its `whyReason` long-form explanation, tightness badge (Exact / Strong / Moderate / Subtle), all other crossings in order, and influence tags.
8. **Landmark legend strip**: Bottom-left legend listing the cinematic attractions for that city.
9. **Return to Globe**: One-tap return triggers the inverse animation — camera rises, clouds thin, globe resumes.

**Observatory Gate**: Immersive-mode users clicking a city in fullscreen see an Observatory Gate modal explaining City Dive and offering to enable Observatory mode. Lite-mode users see the standard city detail card.

**Supported cities with landmark data**: Athens, Rome, Paris, London, New York, Los Angeles, Tokyo, Kyoto, Cairo, Istanbul, Barcelona, Berlin, Amsterdam, Prague, Vienna, Sydney, Dubai, Singapore, Buenos Aires, Mexico City, Mumbai, Rio de Janeiro, Bali, Sedona, Glastonbury — and all other cities in the database (with the satellite terrain view still active even without hardcoded landmarks).

### Power Places Carousel & Cosmic Codex
A **curated global gallery** of high-energy locations:

#### Featured Cities (Expandable)
- **Paris**: Venus MC line (romance, artistry)
- **Auckland**: Jupiter IC line (spiritual foundation)
- **Barcelona**: Sun MC line (creative expression, visibility)
- **Nairobi**: Mars AC line (courage, vitality)
- **Bali**: Neptune IC line (spirituality, retreat)
- ...and 50+ more

#### Category Filters
- **Love**: Venus, Libra lines
- **Career**: Sun, Midheaven, Mercury lines
- **Growth**: Jupiter, Sagittarius lines
- **Spiritual**: Neptune, Pluto, 12th House lines
- **Creativity**: Venus, Mercury, 5th House lines

#### Power Place Card
Each card displays:
- Real Wikipedia photo (or NASA Blue Marble crop)
- City name, coordinates
- Dominant planetary lines active there
- Power Score (0–100 based on chart strength at that location)
- Suggested rituals (meditation, oracle pull, Soul Frequency tuning)

#### Cosmic Codex Export
Exportable **PDF report** for each power place, including:
- Full astrocartography reading tailored to that location
- Suggested arrival window (transit timing for maximum benefit)
- Local meditation/spiritual guidance
- Past Akashic artifacts tied to that location (if user has visited before)

---

## Global Pulse & Psychic Field Index

### Global Pulse Map
A **hyper-detailed real-time global dashboard** overlaying planetary phenomena with psychic field topology:

- **Geocoded Events**: Live eclipses, meteor showers, lunation times, solar flares, all pinned on world map with timeline.
- **Psychic Field Mesh**: Network of nodes representing geomagnetic hotspots, spiritual power centers, and earthquake zones. Overlay shows field strength (color intensity).
- **Live Overlays**: Schumann resonance waveforms, aurora activity, geomagnetic storms all visualized in real-time.

### Psychic Field Index Cards
**Tarot-style index** of global conditions:

#### Condition Tags
- **Extreme**: Geomagnetic storm active, major eclipse imminent, or planetary stellium converging (red card)
- **Turbulent**: Retrograde season, Chiron activated, or multiple squares in transit (orange card)
- **Elevated**: Harmonious aspects, new moon, or Venus influence (yellow card)
- **Mild**: Neutral transit day, waning moon (blue card)
- **Calm**: New lunar phase, few active transits, peaceful geomagnetic conditions (green card)

#### Card Content
Each card includes:
- Geopolitical / spiritual commentary (e.g., "Intense Mars-Pluto square over Middle East; expect political shifts")
- Recommended practices for the day (meditation, grounding, oracle pull)
- Chakra alignment for the current sky
- Suggested power location or astrocartography line to activate

### Current Pulse Dashboard (Expanded)
The living **heartbeat of Heliora Studio**, now with 10 real-time subsystems:

1. **Real-Time 3D Sky**: Live planetary positions, moons, constellation lines, animated.
2. **Schumann Resonance Waveforms**: 7.83 Hz baseline with live fluctuations (from NOAA SWPC).
3. **Planetary Overview**: Current sign ingresses, retrograde status, angular distance from user.
4. **Moon Phase**: Exact illumination %, sign, nakshatra (Vedic), house placement, phase descriptor (waxing crescent, first quarter, etc.).
5. **Active Transits**: Top 5 most potent current transits to user's natal chart (e.g., "Venus trine Natal Venus").
6. **Planetary Hours**: Current hour ruler and its astrological meaning.
7. **Chakra Pulse**: Which chakras are most activated by current sky.
8. **Retrograde Tracker**: All retrograde planets, stations, shadow entry/exit dates, narrative guidance.
9. **Earth Rhythms**: Geomagnetic Kp index, solar wind speed, particle flux, daylight/darkness %, seasonal markers.
10. **Age of Aquarius Progress**: 2-year orb and percentage through the 26,000-year great precession cycle.

---

## Pricing & Tiers

Heliora Studio uses a **dual-currency economy** emphasizing free access, privacy, and fair monetization:

### Essence (Daily Soul Battery)
- Renewable daily at sunrise.
- Spent on light AI reads: Daily Horoscope (1), Daily Affirmation (1), Tarot pull (1), Synastry quick check (2), single Oracle chat (3).
- Refills to tier cap daily.

### Stardust (Celestial Savings)
- Non-renewable except via monthly grants on paid tiers, login streaks, referrals, or Stripe top-ups.
- Spent on premium rituals: Saga-length Oracle reading (5), full Soul Frequency ritual (2,500), Astrocartography cosmic codex export (100).

### Tier Comparison

#### Neophyte (Free, Forever, No Card)
- **✨ Immersive graphics tier (free)**: the living sky — planet atmospheres, moon systems, asteroid belts, interstellar dust, comets, and the space-weather overlay, all in motion
- Full natal chart with Calc Engine transparency
- 3D Sky at Birth + Live 3D Sky (Immersive Mode opt-in)
- NASA-grade 3D cinematic sky with 88 constellations
- Natal Chart with all 8 metrics (Resonance, Epic/Legendary, Complexity, Stelliums, Retrograde Weight, Karmic Load, Luminary Trinity, Chaos vs. Order)
- Current Pulse dashboard (10 live systems)
- Celestial Almanac (eclipses, lunations, retrograde stations)
- Brainwaves & Meditation atlas with chakra table
- Tarot (3-card and Celtic Cross pulls, 1 Essence each)
- Oracle Copilot, free Whisper readings anchored to your chart (1 Essence each)
- **50 Essence at signup** then **25 Essence refilled each day** you return, **7,500 Stardust signup gift**, **1,000 Stardust every day you return** (the daily Stardust only lands on days you come back, so a balance only grows through daily interaction)
- **Astrocartography**: fully interactive 3D Earth globe, viewable for **5,000 Stardust per session** on the free tier (free and unlimited on Adept/Magus)
- **Fully interactive 3D scenes**: the 3D Sky at Birth and the Astrocartography globe are drag-to-rotate, scroll/pinch-to-zoom, clickable, and fullscreen-explorable on desktop and mobile
- Akashic Library (save readings)
- Royal Star alignments, Stellium detection, Major aspects, Personal daily forecast
- **Settings & Personalization, free for everyone**: Tropical/Sidereal zodiac, Whole Sign/Placidus/Equal houses, modern/traditional/hybrid rulerships, five interpretation tones (Mystical, Balanced, Clinical, Psychological, Conversational), Beginner→Advanced disclosure, Lite/Immersive performance mode, professional mode, and lunar-node/asteroid/fixed-star toggles, plus theme, public-profile privacy and notifications.
- **Mobile-first, fast, accessible, zero friction.**

#### Adept ($4.99 per lunar cycle ≈ $5/month)
- Everything in Neophyte, plus:
- **🔭 Observatory graphics tier**: the full deep-sky exploration engine — fly past the Oort cloud into volumetric nebulae, historical supernovae (SN 1054, Tycho, Kepler), black holes (Sgr A*, M87*), binary stars, galaxies, and proper motion across 13,000 years
- **Astrocartography v3** with 68+ planetary lines, power places carousel, power scores
- **Synastry Compatibility Engine** (relationship charts with deep aspect analysis)
- **Soul Frequency music rituals** with MP3 download, harmonic analysis, Akashic save (2,500 Stardust per ritual)
- **Akashic Library save** (save every reading, every ritual, every session)
- **Chakra Atlas**, plus the **Babylonian and Zoroastrian** interpretive lenses
- **Ad-free across the entire app**
- **25 Essence daily refill**, **8,000 Stardust monthly**
- Chakra Pulse dashboard (real-time brightest/quietest centers)
- Cosmic Codex PDF exports (500 Stardust each)
- Voice-anchored Tarot readings (export as MP3)
- API read-access (house cusps, planetary positions for any moment/location)

#### Magus ($9.99 per lunar cycle ≈ $10/month)
- Everything in Adept, plus:
- **Unlimited Soul Frequency rituals** (zero Stardust cost)
- **Unlimited Oracle counsel** of any length (Verse, Saga, Auto all free; priority queue during peak hours)
- **Zodiac Laboratory**: four dedicated research environments exclusive to Magus
  - **Uranian Astrology** (Hamburg School): 90-degree dial, midpoint trees, symmetry axes, planetary pictures, heat map of midpoint density
  - **Vedic/Jyotish**: ayanamsha switching (Lahiri, Raman, KP, Fagan-Bradley), rashi chart, 27 nakshatras with padas, Vimshottari Dasha timeline, yoga detection (Raja, Dhana, Viparita, Pancha Mahapurusha), Shadbala strength scoring
  - **Solar Arc and Predictive**: lifetime activation timeline (solar arc directions + secondary progressions), 7 life-theme clusters (Career, Relationships, Home, Spirituality, Creativity, Transformation, Public Life), directed midpoint hits, progressed Moon timer
  - **Traditional Horary**: Lilly/Bonatti judgment engine, querent and quesited significators, essential and accidental dignity scoring, applying aspects, reception analysis, radicality strictures
- **3D Lab Time Navigator**: play/pause/reverse at 6 speeds (1x to 100,000x), scrub 2000 BCE to 2500 CE, Journey Mode cinematic sweep, 4 camera modes (Free/Ecliptic/System/Deep Space), per-body visibility toggles, orbital path rings
- **Traditional Predictive Astrology**: firdaria, annual profections (time-lord techniques)
- **Hellenistic interpretive lens**
- **Free Cosmic Codex PDF exports** (zero Stardust)
- **Unlimited Saga (long-form) Oracle readings** at zero cost
- **1,000 Essence daily refill**, **25,000 Stardust monthly**
- **Priority Oracle queue** (response within 60 seconds vs. standard queue)
- Custom power place ranking (personalize power place algorithm to user's chart priorities)
- Seal Transmission unlimited (save every Oracle answer forever)

---

## Advanced Astrology Systems Supported

- **House Systems**: Placidus, Whole Sign, Koch
- **Coordinate Systems**: Tropical, Sidereal (Lahiri), Heliocentric
- **17 Celestial Bodies**: Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, Chiron, North Node, South Node, Fortuna, Vertex, Ascendant, Midheaven
- **Aspects**: Conjunction, Opposition, Trine, Square, Sextile, Quincunx, Semi-sextile, Novile, Septile, Quintile, Sesquiquadrate, Semi-square, Sesqui-square
- **Fixed Stars**: Royal stars (Aldebaran, Regulus, Antares, Fomalhaut) plus 50+ classical fixed stars (Sirius, Polaris, Vega, etc.) with traditional meanings
- **Arabic Parts**: Part of Fortune, Part of Spirit, Part of Eros, Part of Victory, Part of Tragedy, and 30+ classical parts
- **Profections**, **Firdaria**, **Secondary Progressions**, **Solar Returns**, **Synastry**, **Composite**, **Davison**, **Astrocartography**
- **Gnostic Typology**: Hylic (matter-led), Psychic (soul-led), Pneumatic (spirit-led) classification engine
- **Harmonic Analysis**: Elemental balance, modality distribution, luminary trinity analysis
- **Uranian Astrology / Hamburg School** (Magus): 90-degree symmetrical dial, midpoint tree computation, midpoint pictures (A = B/C), symmetry axis analysis, heat map of midpoint density, Witte and Ebertin Cosmobiology tradition
- **Vedic / Jyotish** (Magus): ayanamsha switching across four schools (Lahiri, Raman, Krishnamurti KP, Fagan-Bradley), rashi chart with whole-sign houses, 27 nakshatras with lord, symbol, and pada divisions, Vimshottari Dasha planetary period timeline, yoga detection (Raja, Dhana, Viparita, Pancha Mahapurusha, Saraswati), Shadbala six-fold strength scoring per planet
- **Solar Arc Directions** (Magus): directed positions for all planets advanced by the solar arc, lifetime activation timeline across past/current/future windows, secondary progressions (progressed Sun, Moon, and Ascendant with sign ingress dates), 7 life-theme cluster weighting, directed midpoint hits on the natal dial
- **Traditional Horary** (Magus): classical Lilly/Bonatti judgment engine, 1st-house querent and category-keyed quesited significators, essential dignity table (domicile, exaltation, triplicity, term, face, detriment, fall) plus accidental dignity (angularity, speed, combustion, direction), applying and separating Ptolemaic aspects with orb, mutual reception analysis, radicality strictures (early/late Ascendant, void-of-course Moon), five-verdict outcome scale (Favourable, Qualified yes, Uncertain, Qualified no, Unfavourable)

---

## Production Value & Quality Metrics

### NASA Imagery & Provenance
- **Blue Marble** (Earth, photorealistic, CC BY 4.0)
- **Cassini** (Saturn, rings, moons, high-res)
- **Messenger** (Mercury, crater detail)
- **Viking** (Mars, dust, canyons)
- **Hubble** (deep space, background galaxies)
All textures licensed CC BY 4.0, stitched into ephemeris-accurate 3D spheres.

### Calculation Precision
- **Ephemeris**: JPL DE440 (accurate ±1 km over centuries)
- **Aspect Orbs**: Sub-arcsecond (±0.01°) with configurable 0.5°–8° tolerance orbs per aspect type
- **Fixed Stars**: 17+ royal/classical stars with precession-corrected positions
- **Astrocartography**: Right ascension, oblique ascension, azimuth-altitude conversions with Mercator projection accuracy

### Performance Engineering
- **WebGL Texture Budget**: ~600KB for full cinematic rig (88 constellations, planets, moons, galaxies)
- **Dual Mode Architecture**: Lite (SVG only) loads in <1 second; Immersive (Three.js) opt-in after core experience
- **Animation Loop**: Continuous 60 FPS planetary orbits, smooth transitions, no jank
- **Mobile-First**: Responsive design, touch-friendly, sub-3G optimized

### Security & Privacy by Default
- **Encrypted in transit**: All traffic is TLS 1.2+/HTTPS, enforced with HSTS and a strict Content-Security-Policy (upgrade-insecure-requests). No plaintext connections.
- **Encrypted at rest**: Birth data, readings, and all user artifacts are stored on AES-256-encrypted disks (Supabase/Postgres). API provider keys live only in server-side secrets, never in the browser bundle.
- **Row-Level Security on every table**: Supabase RLS gates each table so a user can only ever read their own rows; billing and secret tables are service-role only.
- **Private by default**: Public Profile is opt-in. Charts and readings are visible only to you unless you explicitly share or broadcast them.
- **Never sold**: Zero analytics tracking (no Google Analytics, Mixpanel, or third-party pixels). We do not sell or rent your data, ever.
- **Deletion guarantees**: One-click account deletion purges your charts, readings, and rituals from our servers (GDPR-aligned).
- **Honest scope**: Heliora Studio is not end-to-end encrypted. Because the AI Oracle, interpretations, and Tarot must read your chart server-side to generate readings, our systems can process your data to provide the service. We protect it with the controls above; we do not claim zero-knowledge.

### Production Polish
- **Oracle Voice**: Trained voice model for tarot narration and oracle responses (exportable MP3)
- **UI/UX**: Dark violet aesthetic, soft commands, poetic copy (no em dashes), accessibility WCAG 2.1 AA
- **Brand Voice**: Oracle-toned, conversational, mystical yet grounded, respectful of all traditions
- **Mobile Support**: Full functionality on iOS/Android, gesture-friendly, battery-optimized
- **No Synthetic Testimonials**: All claims in this document are verifiable product features, not fabricated user counts or star ratings

---

## Technology Stack

- **Calculation Engine**: astronomy-engine (Swiss Ephemeris grade), JPL DE440 ephemeris
- **3D Rendering**: Three.js with ACES Filmic tone mapping, 600KB WebGL budget, continuous animation
- **AI Models**: 
  - Google Gemini for chart interpretation and Oracle Copilot
  - Heliora Studio Harmonic Engine (custom) for Soul Frequency music generation via Supabase Edge Functions
  - astronomy-engine (Swiss Ephemeris grade) for all celestial calculations, astrocartography line math
- **Frontend**: React 18+, TypeScript, Vite, Tailwind CSS, Framer Motion (animations)
- **Auth**: Supabase with Google, GitHub, Discord OAuth
- **Database**: Supabase PostgreSQL with row-level security (RLS)
- **Hosting**: Vercel (edge functions, CDN, geo-redundancy)
- **APIs**: 
  - NOAA SWPC (geomagnetic, solar wind, real-time)
  - Wikimedia Commons (city photos, power places)
  - Google Maps Geocoding (location lookup)
  - Stripe (payments, Magus/Adept subscriptions)

---

## Pages & Routing

### Core Experience
- **Home** (https://heliora.studio/): Landing page, feature highlights, sign-up, natal chart generator
- **Dashboard** (https://heliora.studio/dashboard): Current Pulse, Transits, Chakra Pulse, Real-Time 3D Sky
- **Natal Chart** (https://heliora.studio/natal-chart): natal chart wheel, Calc Engine panel, all 8 metrics

### 3D & Visualization
- **3D Sky at Birth** (https://heliora.studio/sky-at-birth): Immersive 3D solar system at birth moment
- **Live 3D Sky** (https://heliora.studio/3d-sky): Real-time current planetary positions
- **3D Lab** (https://heliora.studio/lab3d): Precision Lab engine + a navigable living universe. Render-on-demand, ±13,000-year scrubbing, Brady-style parans and star phases, Constellation Mode (Andromeda/M31), 2D chart render, and a deep-sky exploration engine — clickable black holes (Sgr A*, M87*), historical supernovae on the timeline (SN 1054, Tycho 1572, Kepler 1604), comets with ion and dust tails, volumetric nebulae (Orion/Lagoon/Eagle), binary stars, and a space-weather overlay. Magus adds the Time Navigator (6 speeds, 2000 BCE to 2500 CE scrubber, Journey Mode, camera modes, orbital paths). Adept/Magus free; Neophyte 2,500 Stardust per session. Also hosts the Zodiac Laboratory (Uranian, Vedic, Solar Arc, Horary) — Magus only
- **Cinematic Mode** (https://heliora.studio/cinematic-mode): Toggle Lite ↔ Immersive rendering
- **Lite Mode** (https://heliora.studio/lite-mode): SVG-only, performance-optimized view

### Soul & Oracle
- **Mystic Oracle** (https://heliora.studio/mystic-oracle): Tarot spreads, Italian deck, voice narration
- **Oracle Copilot** (https://heliora.studio/oracle-copilot): Chat with AI that knows your chart
- **Tarot** (https://heliora.studio/tarot): 3-card pulls, Celtic Cross, custom spreads
- **Seal Transmission** (https://heliora.studio/seal-transmission): Save Oracle readings to Akashic Library

### Memory & Archives
- **Akashic Library** (https://heliora.studio/akashic-library): All saved artifacts (Soul Frequencies, Oracles, Astrocartography, Synastry)
- **Soul Frequency Archive** (https://heliora.studio/soul-frequency-archive): All generated rituals with harmonic metadata
- **Oracle Archive** (https://heliora.studio/oracle-archive): All tarot spreads and oracle readings, timestamped
- **Astrocartography Archive** (https://heliora.studio/astrocartography-archive): Saved power place visits, cosmic codex PDFs
- **Synastry Archive** (https://heliora.studio/synastry-archive): Saved relationship charts, compatibility scores

### Music & Meditation
- **Soul Frequency** (https://heliora.studio/soul-frequency): Harmonic ritual generation, player, MP3 download, Akashic save
- **Ritual Player** (https://heliora.studio/ritual-player): Waveform playback, generation cost tracking, share actions
- **Harmonic Analysis** (https://heliora.studio/harmonic-analysis): Elements, modalities, luminary trinity, aspect tension, emotional tone
- **Brainwaves** (https://heliora.studio/brainwaves): Delta/Theta/Alpha/Beta/Gamma atlas with consciousness states
- **Meditation Guide** (https://heliora.studio/meditation-guide): Step-by-step practice recipes (box breathing, grounding, open-monitor)
- **Chakra Atlas** (https://heliora.studio/chakra-atlas): 7-center table with Hz, bija mantras, planets, gemstones, activation
- **Chakra Pulse** (https://heliora.studio/chakra-pulse): Real-time brightest/quietest chakra analysis with guidance

### Location & Travel
- **Astrocartography** (https://heliora.studio/astrocartography): 68+ planetary lines, globe + map dual view, line toggles
- **Power Places** (https://heliora.studio/power-places): Global carousel, category filters (Love/Career/Growth/Spiritual/Creativity)
- **Cosmic Codex** (https://heliora.studio/cosmic-codex): Exportable PDFs for each power place with local astro guidance
- **Planetary Lines** (https://heliora.studio/planetary-lines): Deep-dive into line math, MC/IC/AC/DC definitions, astrocartography v3 details
- **Astrocartography Map** (https://heliora.studio/astrocartography-map): Interactive Mercator + globe, all 17 planets, line toggles, real-time exploration

### Real-Time & Global
- **Current Pulse** (https://heliora.studio/current-pulse): 10-system dashboard (3D sky, Schumann, planetary overview, moon, transits, hours, chakra, retrogrades, earth rhythms, age of Aquarius)
- **Global Pulse** (https://heliora.studio/global-pulse): Geocoded events, psychic field mesh, geomagnetic overlays
- **Psychic Field Index** (https://heliora.studio/psychic-field-index): Extreme/Turbulent/Elevated/Mild/Calm condition cards with guidance
- **Schumann Resonance** (https://heliora.studio/schumann-resonance): Live 7.83 Hz waveforms, anomaly detection, geomagnetic correlation

### Relationships & Compatibility
- **Synastry** (https://heliora.studio/synastry): Relationship compatibility engine, aspect analysis, Akashic save
- **Relationship Compatibility** (https://heliora.studio/relationship-compatibility): Deep synastry dive, composite/davison charts (Magus+)

### Transits & Forecasting
- **Transits** (https://heliora.studio/transits): Top transits to natal chart, timing, interpretations
- **Planetary Hours** (https://heliora.studio/planetary-hours): Real-time hour ruler, astrological meaning, optimal action timing
- **Daily Forecast** (https://heliora.studio/daily-forecast): Love/Finance/Spirit forecasts tuned to Venus/Saturn/Sun
- **Retrogrades** (https://heliora.studio/retrogrades): All retrograde planets, station dates, shadow entry/exit, narrative

### Almanac & Events
- **Celestial Almanac** (https://heliora.studio/celestial-almanac): Sign ingresses, retrograde stations, moon quarters, eclipses, equinoxes, past/now/ahead timeline
- **Eclipses** (https://heliora.studio/eclipses): Solar + lunar eclipses, path, timing, astrological significance
- **Moon Phases** (https://heliora.studio/moon-phases): Current phase, exact %, sign, nakshatra, house, phase descriptor

### Monetization & Developer
- **Pricing** (https://heliora.studio/pricing): Neophyte/Adept/Magus comparison, Essence/Stardust explained, tier selection
- **Neophyte** (https://heliora.studio/neophyte): Free tier details, all included features, upgrade path
- **Adept** (https://heliora.studio/adept): $4.99/lunar month tier, astrocartography, soul frequency, synastry, API read
- **Magus** (https://heliora.studio/magus): $9.99/lunar month tier, unlimited rituals, predictive astrology, API write, priority oracle
- **API** (https://heliora.studio/api): Developer overview, rate limits, pricing
- **Developer Docs** (https://heliora.studio/developer-docs): Full API reference, authentication, examples, webhook setup
- **API Key** (https://heliora.studio/api-key): Manage personal API keys, usage analytics, billing

### Legal & Support
- **Privacy Policy** (https://heliora.studio/privacy): Data handling, Supabase RLS, encryption at rest, deletion guarantees, GDPR compliance
- **Terms of Service** (https://heliora.studio/terms): Entertainment and spiritual exploration, 18+, no medical/financial advice, dispute resolution
- **Contact** (https://heliora.studio/contact): contact@heliora.studio, support request form, bug reports, feature requests

### Reference & LLM Content
- **llms.txt** (https://heliora.studio/llms.txt): This document (short form, SEO-optimized)
- **llms-full.txt** (https://heliora.studio/llms-full.txt): Extended feature documentation for LLM ingest

---

## Brand Voice & Tone

- **Oracle-Toned**: Poetic, mystical, wise, calm, introspective
- **Readable**: Plain language, no jargon or gatekeeping, accessible to all
- **Soft Commands**: "Explore your birth sky" not "Click here"
- **Dark Violet Aesthetic**: Mysterious, premium, celestial mood
- **No Em Dashes**: Use commas, semicolons, or full stops instead
- **Respectful of Traditions**: Blends Western, Vedic, Gnostic, and modern frameworks without reducing them

---

## Evidence & Social Proof Policy

Heliora Studio does **not** publish synthetic testimonials, invented user counts ("1 million charts read"), or fabricated star ratings in crawler-facing content. All claims in this document are verifiable product capabilities:

- Feature descriptions are drawn from actual codebase and live product
- Pricing tiers and tier features are accurate as of 2026-05-28
- Calculation engine, ephemeris source, and technology stack are auditable
- Privacy claims (RLS, encryption, deletion) are implemented and tested

We welcome scrutiny and audit of these claims by security researchers, astrologers, and users.

---

## Crawling & Indexing Policy

All major AI crawlers are **explicitly welcomed** and may freely ingest this site for both training and retrieval purposes:

- GPTBot, ChatGPT-User, OAI-SearchBot
- PerplexityBot, Perplexity-User
- ClaudeBot, claude-web
- GoogleBot, Bingbot, other major search engines
- Meta, Anthropic, and other research/commercial crawlers

This site intentionally **does not block any AI crawlers**. We believe transparent, crawlable content serves everyone.

---

## AI Models & Services Used

- **Google Gemini**: Chart interpretation, Oracle Copilot, conversational AI (Whisper, Verse, Saga modes)
- **Heliora Studio Harmonic Engine**: Soul Frequency music generation (custom model), invoked via Supabase Edge Functions with async create-then-poll flow
- **astronomy-engine**: Swiss Ephemeris-grade celestial calculations, JPL DE440 ephemeris, astrocartography line math, aspect precision
- **Three.js**: 3D rendering, 88 constellations, orbital mechanics, real textures, continuous 60 FPS animation loop

---

## Deep Dive & Future Reading

- **Full Sitemap**: https://heliora.studio/sitemap.xml
- **Long-Form LLM Content**: https://heliora.studio/llms-full.txt
- **Privacy & Data**: https://heliora.studio/privacy
- **Developer API**: https://heliora.studio/developer-docs

---

**Heliora Studio** — *The most precise astrology platform ever drawn in 3D. Private. Free. Yours.*