deck_in_a_dash/docs/reading.md

# Your daily reading, explained

This page describes what actually happens when you get a reading —
no code, no jargon you haven't already agreed to. If you just want to
know "what am I looking at", start here.

## The one-time setup: telling it who you are

Before you can get a personal reading, you tell it a few things about
your birth, once:

- the **date** and **time** you were born, and which time zone that
  clock time was in
- **where** you were born (latitude/longitude)

That's it. This information never changes and is only used to work out
exactly where the planets were, and which zodiac sign was rising, at the
moment you were born — your **natal chart**. Everything else the app
does is compared against that one fixed reference point.

You can also choose a **language** for your reading - English or German.
Every part of the reading described below, including the guidance
paragraph at the end, is available in either; switching languages
doesn't change any of the astrology or the tarot draw itself, only how
it's worded.

## What happens every day

Each day, the app does two independent things and then combines them:

1. **It looks at the sky right now** and compares it to your natal
   chart from step one — this tells you what's changing today,
   relative to your own personal baseline (not a generic horoscope).
2. **It shuffles a tarot deck**, using today's date as the shuffle
   "seed". This means: if you check your reading three times on the
   same day, you get the exact same 10 cards, in the same order, every
   time — it only changes when the date changes. There's no randomness
   involved beyond that; today's date fully determines today's spread.

## The three parts of a reading

### 1. Your natal chart

A snapshot of the sky at the moment you were born: where the Sun,
Moon, and each planet were, which zodiac sign was rising on the
eastern horizon at that moment (your **Ascendant**), and which of the
12 astrological "houses" each planet falls into as a result. Think of
this as your personal baseline — it doesn't change day to day, and
every other part of the reading is measured against it.

### 2. Today's sky (your "transits")

Where the Sun, Moon, and planets are positioned *today*, plus:

- the current **Moon phase** (New, Waxing Crescent, Full, and so on)
- any **aspects** — meaningful angles formed between where a planet is
  today and where a planet sat in your natal chart. For example, "the
  Sun is opposite your natal Moon today" is one aspect. These are the
  traditional signals astrologers use to say a day is emotionally
  charged, a good day for decisions, a day of tension, etc. Not every
  day has aspects; some days are quiet.

Each planet's position today is also placed into one of *your* 12
houses (not a fresh chart for right now) — that's the standard way
astrologers read "what house is this transit happening in for me".

### 3. Your tarot spread (the Celtic Cross)

A classic 10-card tarot layout, drawn from the 22 Major Arcana cards
(The Fool, The Magician, and so on through The World). Each of the 10
positions asks a different question about your day or situation — for
example, "what covers you right now", "what crosses/challenges you",
"your hopes and fears", "the likely outcome". Every card can land
**upright** or **reversed**, which traditionally shades or inverts its
meaning. The order and meanings of the 10 positions, and the meaning
of each card, come from A. E. Waite's original 1911 description of the
spread — the same source most modern tarot decks trace back to.

## How "big" is today?

Not every day is equally eventful astrologically. A separate,
optional step can look at today's aspects (part 2, above) and works
out an overall **significance level** for the day — Quiet, Notable,
Significant, or Major, shown together with its rank out of those four
(for example "Notable (2/4)") — based on which planets are involved,
how exact the angle is, and whether it touches your Sun or Moon (the
two most personally weighted points in a chart). On a genuinely Major
day, it also calls out the single most important thing happening, as a
hint that it's worth paying closer attention to your tarot spread that
day rather than treating it as routine. Quiet days still get a full
reading — this step only adds a "pay attention today" flag, it never
removes anything.

For each of the handful of events that make up today's score, you also
get a plain sentence about what it classically means and *which area
of your life* it's playing out in — drawn from the house it falls in
(see "Today's sky", above). For example, a tense aspect from Saturn
landing in your 6th house reads as a day for your daily work and
routine to feel a bit stuck, not just "Saturn is doing something."
That wording is condensed from a public-domain 1920 astrology book
(Sepharial's *Transits and Planetary Periods*), the same way the tarot
card meanings are condensed from Waite's 1911 book.

Every day — Quiet or Major — the app also reads out your full 10-card
Celtic Cross spread, position by position, each with that card's actual
meaning (drawn from the same Waite text as the rest of the reading), so
you get one complete, readable account of the spread rather than just
a list of card names.

After that spread, you get a short paragraph of actual guidance: how to
meet the day, given both the single biggest transit happening and your
own tarot spread. It looks at that transit's character (is it an easy
angle or a tense one?) together with your *Attitude* card — the
position Waite describes as "his position or attitude in the
circumstances", i.e. how you're currently approaching things — upright
or reversed, and gives a concrete stance to take today. It then names
your *Attitude* and *Outcome* cards again, this time spelling out what
each one actually means for the orientation it landed in — so instead
of just "your Outcome card is the Wheel of Fortune, reversed" you get
that card's real meaning alongside it. This is the one place the app
actually combines the astrology and the tarot into a single piece of
advice, rather than leaving you to read them side by side yourself, and
it's printed last, as the closing takeaway once you've seen the full
spread it's referring to.

The wording flexes with how big the day is: on a Major day it opens
with something like "With Pluto as today's dominant influence"; on a
quieter day with only a mild aspect in play it's softer, e.g. "With a
mild touch from Jupiter today" or, fainter still, "Mercury is only
faintly active today, but for what it's worth"; and on a genuinely
uneventful day with no aspects at all, there's no planet to name, so it
falls back to a plain read of your Attitude card's orientation alone
("There's no standout transit today - it's an astrologically quiet
day..."). The underlying stance advice itself doesn't change with
intensity — only how insistently it's introduced.

## What a day's reading actually gives you

Put together, one day's reading contains: your natal chart (for
reference), today's sky and how it's speaking to your chart, how
significant today is overall (with a plain-language note on each of the
main events driving that), your full 10-card Celtic Cross spread read
out card by card with each card's meaning, and — every day, not just
Major ones — a closing paragraph of guidance tying the day's biggest
transit to your Attitude and Outcome cards specifically. Attitude and
Outcome get that treatment in the closing guidance; the other eight
positions are read in light of your natal chart and today's sky, the
way the worked example below does by hand.

## A worked example

Here's what an actual day's reading looks like end to end, for someone
born 14 March 1988 in Berlin, checking their reading on 5 July 2026.

**Natal chart (excerpt).** Sun in Pisces, Moon in Aquarius, Ascendant in
Sagittarius.

**Today's sky (excerpt).** Moon phase: Waning Gibbous. Several planets
are forming aspects back to the natal chart above — see below for which
ones actually matter.

**How big is today, and the significant transits.**

```
Day significance: Major (4/4)
(a major transit today - worth a deeper Celtic Cross look)

Top 5 significant transits:
  1. Transiting Pluto in Aquarius (house 3) Conjunction natal Moon in Aquarius (house 3) (orb 2.9°, score 9.60)
     In matters of communication, siblings, and everyday learning (house 3). Brings deep, often
     hidden transformation - the surfacing or dismantling of something that has outgrown its old form.
  2. Transiting Neptune in Aries (house 5) Sextile natal Moon in Aquarius (house 3) (orb 2.5°, score 9.25)
     In matters of romance, creativity, and children (house 5). Brings a state of chaos and confusion -
     an involved, uncertain condition of affairs, with plots, subtlety, or unseen influences at work.
  3. Transiting Uranus in Gemini (house 7) Trine natal Moon in Aquarius (house 3) (orb 2.0°, score 8.96)
     In matters of partnerships and close relationships (house 7). Brings separations, estrangements,
     sudden dislocations and violent upsets. Success through official or civic channels, and beneficial
     changes or appointments, are possible.
```

In plain terms: today is about as big as this reading gets (Major,
4 out of 4), and the story is squarely about the Moon — a slow-moving
Pluto sitting right on top of it, a chaotic Neptune touching it gently
from the 5th house, and a disruptive-but-possibly-lucky Uranus trine
from the 7th. Communication, romance, and relationships are all
quietly under pressure at once.

**The Celtic Cross, read out in full** (drawn independently, using
today's date):

```
Celtic Cross:
  1. The Present: The Emperor (Reversed)
     This covers him: the general influence affecting the matter.
     Benevolence, compassion, credit; also confusion to enemies, obstruction, immaturity.
  2. The Challenge: The Devil
     This crosses him: the nature of the obstacle in the matter.
     Ravage, violence, vehemence, extraordinary efforts, force, fatality.
  3. The Crown: The Empress
     This crowns him: the aim or ideal, the best that can be achieved.
     Fruitfulness, action, initiative, length of days; also difficulty, doubt, ignorance.
  4. The Foundation: Justice
     This is beneath him: the basis of the matter, already actual.
     Equity, rightness, probity, executive; triumph of the deserving side in law.
  5. The Recent Past: Temperance
     This is behind him: the influence that is just passing away.
     Economy, moderation, frugality, management, accommodation.
  6. The Near Future: The World (Reversed)
     This is before him: the influence now coming into action.
     Inertia, fixity, stagnation, permanence.
  7. Himself: The Magician
     His position or attitude in the circumstances.
     Skill, diplomacy, address, subtlety; self-confidence, will.
  8. His House: The Hermit (Reversed)
     His environment and the tendencies at work therein.
     Concealment, disguise, policy, fear, unreasoned caution.
  9. Hopes and Fears: The Moon (Reversed)
     His hopes or fears in the matter.
     Instability, inconstancy, silence, lesser degrees of deception and error.
  10. The Outcome: Strength
     What will come: the final result of the matter.
     Power, energy, action, courage, magnanimity; complete success and honours.
```

**The closing guidance**, tying the day's biggest transit (Pluto,
above) to the Attitude and Outcome cards from the spread just shown:

```
With Pluto as today's dominant influence: Today concentrates whatever you already
bring to it - your current approach will be amplified, so make sure it's the one
you want.
Your Attitude card is The Magician: Skill, diplomacy, address, subtlety; self-confidence, will.
The spread's likely Outcome is Strength: Power, energy, action, courage, magnanimity; complete success and honours.
```

Read side by side, the astrology and the tarot happen to rhyme here —
both point toward something that wants to shift (Pluto's "hidden
transformation," The Devil's "force") running into something that
feels stuck (a reversed World, an afflicted Moon). The closing guidance
picks up part of that thread automatically — an upright Attitude card
(The Magician) paired with this neutral, concentrating Pluto transit
becomes "make sure your current approach is the one you want" — reading
every other position (Challenge, Near Future, and the rest) into that
same story the way this paragraph just did by hand is the reader's own
synthesis (see above).

**A quieter day, for contrast.** Someone else — born 10 October 1990 in
Sydney, checking their reading on 15 January 2026 — gets a much lower-key
version of the same guidance, because the biggest thing happening that
day is a loose, single Jupiter aspect rather than an exact Pluto hit:

```
Day significance: Notable (2/4)
...
With a mild touch from Jupiter today: Your instincts are sound, but the day is
testing them - hold your position without forcing the issue.
Your Attitude card is The Sun: Material happiness, fortunate marriage, contentment.
The spread's likely Outcome is Justice: Equity, rightness, probity, executive; triumph of the deserving side in law.
```

Same stance logic (a tense aspect, an upright Attitude card), but the
opening line matches how much the day actually asks of you.

**The same Major day, in German.** Switching languages doesn't change
anything about the reading itself - same cards, same transits, same
guidance logic - only the words:

```
Bedeutung des Tages: Einschneidend (4/4)
(ein einschneidender Transit heute - ein genauerer Blick auf das Keltische Kreuz lohnt sich)

Pluto ist heute der bestimmende Einfluss: Der heutige Tag verstärkt, was du bereits
mitbringst - deine derzeitige Herangehensweise wird verstärkt, also stelle sicher,
dass es die richtige ist.
Deine Haltungskarte ist Der Magier: Geschick, Diplomatie, Gewandtheit, Feinsinn; Selbstvertrauen, Wille.
Das wahrscheinliche Ergebnis des Blatts ist Kraft: Macht, Energie, Tatkraft, Mut, Großmut; voller Erfolg und Ehren.
```