giorgio/read.markets
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

brand: rename product to "Read the Markets" (read.markets)

Browse source 
The product is now "Read the Markets" served at https://read.markets,
with the app at https://app.read.markets. "Cassandra" survives only as
the in-product AI persona (system prompt + "Ask Cassandra" chat label).

Centralised the brand in app/branding.py: BRAND_NAME, BRAND_SHORT,
DOMAIN, SITE_URL, APP_URL, EMAIL_FROM_DEFAULT. Jinja templates pull
{{ BRAND_NAME }} via globals registered in templates_env.py; Python
code reads branding.BRAND_NAME directly. The future-rename surface
is now a one-liner.

Updated: FastAPI app title, every page title (dashboard, news, log,
settings, upload, login, verify), header brand div, auth-card brands,
OTP email subject + HTML + plain-text bodies (incl. uppercase header
tag), OpenRouter X-Title + HTTP-Referer attribution headers, README.
Email tests now assert against branding.BRAND_NAME rather than the
literal string.

Internal identifiers deliberately kept on the legacy "cassandra" name
to avoid invalidating live sessions / advisory locks / configs:
cookies (cassandra_session, cassandra_pending) + itsdangerous salts,
MariaDB GET_LOCK keys, CASSANDRA_TOKEN env var, cassandra.css filename,
pyproject package name, localStorage prefs, outbound User-Agent strings.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
Giorgio Gilestro 2026-05-22 19:39:38 +01:00
parent 9759080134
commit 824d849c63
15 changed files with 82 additions and 39 deletions
Download patch file Download diff file Expand all files Collapse all files

31
app/branding.py
View file

@ -1,11 +1,20 @@
"""Cassandra brand palette — single source of truth.
"""Brand single source of truth — name, domain, palette, fonts.
Both the website's CSS (`app/static/css/cassandra.css`) and the email
templates (`app/services/email_service.py`) draw from these dicts. CSS
hand-authors the values in its `:root` / `[data-theme="light"]` blocks;
a drift-detection test (`tests/test_branding_consistency.py`) asserts
that what's in this module matches what's in the CSS, so updating the
brand in one place without the other fails CI.
The product is **Read the Markets** (read.markets). "Cassandra" remains
the in-product *AI persona* (system prompt + chat label) — distinct from
the brand, the way Slackbot is distinct from Slack. Anything that crosses
into user-visible chrome (page titles, email headers, OpenRouter referer)
must read `BRAND_NAME` from here; do not hard-code the string.
Internal identifiers (`cassandra_session` cookie, pyproject package name,
SQLAlchemy GET_LOCK keys, file `cassandra.css`, env var `CASSANDRA_TOKEN`)
keep the legacy name on purpose — renaming them would invalidate live
sessions / advisory locks / configs for zero brand benefit.
The colour palette below is hand-authored in CSS as well; a drift-
detection test (`tests/test_branding_consistency.py`) parses
`cassandra.css` and asserts every variable matches. Update both or
neither.
The light theme is the *default* in emails — mail clients can't read
`localStorage`, so we can't replicate the dashboard's user-toggled
@ -15,6 +24,14 @@ via media query.
from __future__ import annotations
BRAND_NAME = "Read the Markets"
BRAND_SHORT = "Read"
DOMAIN = "read.markets"
SITE_URL = "https://read.markets"
APP_URL = "https://app.read.markets"
EMAIL_FROM_DEFAULT = f"noreply@{DOMAIN}"
DARK: dict[str, str] = {
"bg": "#0a0e14",
"surface": "#11151c",