Skip to content

feat: add localization for Stellar-specific terminology in the UI #792

Description

@sanmipaul

Summary

The Astera frontend uses Stellar-specific technical terms (stroops, ledger, Horizon, XLM, Soroban) that are unfamiliar to users coming from Ethereum or traditional finance backgrounds. Adding contextual tooltips or a glossary would reduce confusion and lower the learning curve.

Terms to Explain In-Context

Term Plain-language explanation
Stroops The smallest unit of XLM (like satoshis for Bitcoin). 1 XLM = 10,000,000 stroops
Ledger A single block in Stellar's blockchain. Closes every ~5 seconds
Horizon Stellar's API server for querying blockchain data
Soroban Stellar's smart contract platform
TTL Time-to-live: how long data stays stored on the blockchain
Collateral Ratio The value of your collateral vs. the amount you borrowed
Factoring Fee The protocol's fee for facilitating invoice financing

Implementation Options

Option A: Glossary Page

  • `/glossary` page with all terms and definitions
  • Linked from the footer and help sections

Option B: Inline Tooltips

  • Each technical term underlined with a dotted border
  • Hover (or tap on mobile) shows a tooltip with the definition

Option C: Both

  • Inline tooltips for frequently-used terms on the dashboard
  • Full glossary page for comprehensive reference

Acceptance Criteria

  • Glossary page at `/glossary` with all 7 terms above
  • Top 5 most-used technical terms have inline tooltips on the dashboard
  • Tooltips are accessible (keyboard focusable, screen reader compatible)
  • Glossary is linked from the footer
  • New terms can be added by editing a single `glossary.ts` data file

References

  • `frontend/app/`
  • `frontend/components/`

Metadata

Metadata

Assignees

Labels

Stellar WaveIssues in the Stellar wave programdocumentationImprovements or additions to documentationenhancementNew feature or requestfrontendNext.js frontend work

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions