elite-dangerous-credit-account¶
Audience: Agent
Credit Account — hosted web app for a commander credit ledger from Elite Dangerous journal events: income and expenses with timestamps and reasons, crew wages as subrows, sortable/filterable table views (Stellar Scan–style patterns), balance graph, local persistence, and filtered totals plus credits-per-hour over a measurable window.
Stack¶
Vite + Solid + TypeScript (src/). Depends on @howfe/elite-dangerous-event-types and @howfe/inter-frame-messenger (package.json).
Journal intake: src/composables/useJournalConnection.ts — InterFrameMessenger on window with allowlist EliteEvent, Status, EdosFileEvent; handlers today are onEliteEvent and onEdosFileEvent only (bare elite-status not ingested yet). Ledger logic: src/store/creditStore.tsx.
| Env var | Role |
|---|---|
VITE_REMOTE_JOURNAL_READER_URL |
Popup URL (default https://edjr.howfe.org) |
VITE_ALLOWED_SENDER_ORIGINS |
Comma-separated postMessage sender origins for IFM |
VITE_EDOS_BUILD_SERVICE_ORIGIN |
Build API origin (default https://app.edos.howfe.org) |
VITE_DESKTOP_APP_URL |
appUrl wired into Windows .exe builds (default https://edca.howfe.org) |
Run / build¶
cd elite-dangerous-credit-account
npm install
npm run dev
npm run build
npm test
@howfe/* packages resolve from the GitLab npm registry (see project .npmrc; GITLAB_NPM_TOKEN for CI/local).
Runtime URLs¶
| Usage | Default |
|---|---|
| Deployed UI | https://edca.howfe.org |
| Remote journal reader popup | https://edjr.howfe.org |
| Desktop build API | https://app.edos.howfe.org |
No community HTTP APIs in the initial app — journal data only.
Bootstrap / manifest¶
edos.mode=embedded(and transitionaledosEmbedded) — hides Open journal reader; use local journal reader webview or host-driven IFM instead.- Manifest:
public/.well-known/edos-integration.jsonon the app origin (appId:elite-dangerous-credit-account).
Desktop install¶
Use elite-dangerous-local-journal-reader build-service at https://app.edos.howfe.org — do not add Tauri here. Register https://edca.howfe.org in the shell Tauri allowlists when going live (README.md).
Agent notes¶
- Table UX: follow TABLE_GUIDANCE.md; patterns align with Stellar Scan (
BodiesTable, views, filters). - Third-party attribution: footer credits journal data via EDOS journal reader — extend per DESIGN_GUIDANCE.md if community APIs are added later.
Related docs¶
- REPOS.md
- IPC.md — same-window IFM listener
- HOSTED_APP_CONTRACT.md
- apps/elite-dangerous-stellar-scan.md — reference table workspace