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

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or requestfrontendNext.js frontend work

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions