Shared conventions

The sign-in flow, languages, admin areas and environment variable names the three products share.

Sign-in

A company SSO (OIDC) when there is one, otherwise a six-digit code by email. People have no passwords. All three show the same two steps.

  1. Sign in — enter your email and Get the code. Only the one-line hint differs (Galpi creates an account the first time; Mothership takes invited addresses; Naru registered ones).
  2. Enter the code — the sixth digit signs you in. Below are Send the code again and Use another email.
Galpi's sign-inGalpi's sign-in
Galpi's sign-in
Mothership's sign-inMothership's sign-in
Mothership's sign-in
Naru's sign-inNaru's sign-in
Naru's sign-in
  • The link in the mail: the same mail has a link (/auth/verify). Opening it signs nobody in; it shows who asked (browser, OS, IP, time) and asks "Yes, sign me in". Yes signs in the window waiting for the code.
  • Company accounts: the button reads "Sign in with your company account" in all three (or "Sign in with " when named). Accounts are separate per product; register the same company IdP in each and one sign-in carries across. Galpi and Naru take the same OIDC_* variables; Mothership registers SSO per company in its screens.

Language

Korean (default) and English, switched with English / 한국어 on each screen; the default is APP_LANG. The names next to the logos stay Galpi · Mothership · Naru in both languages.

Screens

  • Galpi is the reference: Catalyst's zinc colours, Pretendard, black-and-white primary buttons, a touch of orange. The orange is the same in every product (#d04a02 on light, #fd5108 on dark and in the icons). The other two copy Galpi's values without depending on it at runtime. This site is drawn with the same values.
  • Admin areas open as separate areas ("Galpi / System admin", "Mothership / Company admin", "Naru / Administration"): product and area in the head, a grouped list, one way back at the bottom.
  • Saving: settings pages have a save bar; switches in lists save at once and say so. Widening a scope asks first.
  • Confirmations: the title is a question naming the target, then what will happen as a short list, and "can't be undone" last when it applies. The safe button comes first.
  • Theme: light → dark → system.

Errors

API errors carry a language-independent code. Screens decide by the code and only display the message. Scripts should look at the code too.

Environment variable names

A setting the three share has one name, Galpi's. Settings only one product has start with its name (MOTHERSHIP_…, NARU_…). Older names keep working; when both are set, the older (product-specific) one wins.

Family name Meaning Galpi Mothership Naru
PUBLIC_URL The address people open as is formerly MOTHERSHIP_PUBLIC_URL as is
PORT Port to listen on as is as is as is
DATA_DIR Data folder as is n/a (DATABASE_URL) as is
SECRETS_KEY Seals stored secrets as is formerly MOTHERSHIP_SECRET_ENCRYPTION_KEYS formerly NARU_SECRETS_KEYS
ADMIN_EMAILS Made administrators at start as is operators as is
SMTP_URL, MAIL_FROM Mail server and sender as is formerly MOTHERSHIP_EMAIL_* as is
APP_LANG Default language formerly GALPI_LANG new formerly NARU_LANG
LOGIN_METHODS email, oidc, email,oidc as is n/a (per company in the screens) new
OIDC_* Company accounts (SSO) as is n/a formerly NARU_OIDC_*
S3_* File storage as is formerly MOTHERSHIP_S3_* n/a
LLM_BASE_URL, LLM_API_KEY, LLM_MODEL Model server as is only with LLM_API_FORMAT=openai n/a
MODE_FAST_MODEL, MODE_SMART_MODEL, MODE_DEEP_MODEL Per-tier models create those modes the tier of that name (openai format) n/a

The AI tiers are fast · smart · deep everywhere.

Esc