🐟 XLMFISH Community Site Plan

Overview

The XLMFISH Community site is a core part of xlm.fish — focused on transparency, analytics, and community engagement around the XLMFISH ecosystem.
This section provides real-time visibility into community wallets, treasury activity, and liquidity pools, while serving as a foundation for future governance and interactive tools.

---

🎯 Project Goals

1. Transparency

   • Publicly display treasury and community wallet balances.
   • Track inflows, outflows, and liquidity pool participation.
   • Build trust through accessible, verified data.

2. Utility

   • Provide useful insights into XLMFISH token metrics and ecosystem health.
   • Integrate with Stellar APIs for accurate and timely data.

3. Community

   • Central hub for updates, educational resources, and proposals.
   • Prepare the groundwork for community governance tools.

---

⚙️ Technical Direction

Area	Stack / Approach
Backend	Symfony (PHP) for routing, templating, and API integration
Frontend	TailwindCSS (mobile-first) + Alpine.js or lightweight React components
Data Fetching	Python scripts (from stellar-scripts) feeding cached JSON
APIs	Stellar Horizon API + StellarExpert API
Charts / UI	Recharts or Chart.js + ShadCN/UI or Flowbite components
Design Priority	Functional first, minimal, re-usable, and maintainable

---

🧩 Core Modules

1. Treasury Dashboard

Display real-time balances for treasury and community wallets.

• Pulls from cached JSON generated by backend scripts.
• Shows XLMFISH and XLM balances, valuations, and transaction counts.
• Links to StellarExpert for verification.

2. Liquidity Pools Viewer

List all liquidity pools containing XLMFISH.

• Show pool size, composition, and XLMFISH percentage.
• Include charts for growth and pool distribution.
• Automatically refresh data daily.

3. Wallet Transparency

Comprehensive table of all known community wallets.

• Labels for treasury, LP, and special-purpose wallets.
• Live or cached balances.
• Sortable, mobile-friendly table view.

4. Community Updates

Public communication hub.

• Posts from Markdown files or RSS feed.
• Lightweight CMS feel using existing Symfony templating.

5. Governance (Future)

Prepare for voting and proposal mechanisms.

• Placeholder for wallet-connect (Freighter / Albedo).
• On-chain or off-chain voting integration to be explored later.

---

📆 Implementation Roadmap

Phase	Focus	Deliverables
Phase 1	Core Scaffolding	/community route, Tailwind layout, basic template
Phase 2	Data Integration	JSON data feeds from Python scripts, Treasury + Wallet dashboards
Phase 3	Analytics	Charts, historical views, automatic updates
Phase 4	Engagement	Updates feed, feedback form, social links
Phase 5	Governance	Wallet connect + voting tools

---