Skip to content

Elevating Heroes 🏁 🏁 🏁 🏁 🏁 Immortalizing Legends πŸ† πŸ† πŸ†

License

Notifications You must be signed in to change notification settings

zanuka/leaderport-core-ui

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Sui

In a world of endless data, LeaderPort is your compass to what's winning. From Wall Street to the World Series, never miss a leader in motion. Whether you're tracking top-performing stocks, leading sports scores, trending cryptocurrencies, or competitive metrics, LeaderPort serves as your portal to performance leaders.

With launches planned throughout 2025, the platform will be delivered through three main channels:

  1. Web Application leaderport.io

    • Instant access to public leaderboards
    • Web3 wallet integration for premium features
    • Real-time sports, markets, and competitive data
    • Developer tools, SDKs, utilities and resources
  2. Browser Extensions

    • Transform your browser into a command center
    • Instant leaderboard updates
    • Cross-platform achievement tracking
  3. Mobile Applications

    • Native iOS and Android experiences
    • Real-time notifications
    • On-the-go leaderboard access

Key Platform Features

  1. Real-time Leaderboard Updates

    • WebSocket integration for instant score changes
    • TanStack Query for efficient data management
    • Smooth animations for rank changes
  2. Natural Language Queries

    • Chat and interact with your leaderboard using AI
    • Stream responses in real-time
    • Query complex statistics naturally
  3. Responsive Design

    • Mobile-first approach with desktop enhancements
    • Adaptive layouts for various screen sizes
  4. Player Profile Cards

    • Quick view of player stats and achievements
    • Social sharing capabilities
  5. Multiple Leaderboard Views

    • Global rankings
    • Friend leaderboards
    • Time-based competitions (daily, weekly, monthly)
  6. Search and Filters

    • Find specific players or filter by various criteria

Web3 Focused

Our Web3 integration allows users to connect their Sui Wallet to access premium features, integrate with Web3 games/achievements, and make blockchain-enabled transactions. For more details on our Web3 strategy, check out our Web3 Vision.

Sui

The platform will initially support Sui, the first internet-scale programmable blockchain platform, for Web3 features. Depending on developer demand and community consensus we will consider supporting other blockchains and wallets.

Our roadmap will be highly focused on Web3 gaming and competitive dApps, with extensibility to traditional applications for both free and paid features.

Primary Web3 Features

  1. Permanent Record Keeping

    • Immutable blockchain storage of significant achievements
    • Historical leaderboards preserved indefinitely
    • Verifiable proof of accomplishment
    • Cross-platform achievement persistence
  2. NFT Achievement System with SuiFrens

    • Dynamic NFT minting for major milestones
    • Rarity tiers based on achievement difficulty
    • Tradeable digital collectibles
    • Achievement showcase functionality
    • SuiFrens Integration:
      • Customizable SuiFren characters as achievement badges
      • Progressive trait unlocks based on milestones
      • Community-driven rarity system
      • Cross-platform achievement display
      • Interoperable with SuiFrens ecosystem

Please reference the SuiFrens Integration doc for detailed implementation info.

  1. Community Validation
    • Decentralized verification of major records
    • Community voting on achievement authenticity
    • Transparent validation processes
    • Anti-cheat mechanism integration

Please reference the Web3 vision doc for more detailed info.

Web3 Gaming & NFTs

  • Sui Ecosystem Games: Track player achievements, rankings, and in-game asset performance
  • NFT Collection Rankings: Monitor floor prices, trading volume, and holder statistics
  • Play-to-Earn Leaderboards: Track earnings, achievements, and player progression
  • Cross-Game Achievement Systems: Unified leaderboards across multiple Web3 games
  • SuiFrens Integration: Achievement-based trait unlocks and rarity tracking

DeFi & Trading

  • DEX Trading Volumes: Track top traders and trading pair performance
  • Liquidity Provider Rankings: Monitor top LPs across different pools
  • Yield Farming Performance: Track APY and TVL across protocols
  • Wallet Performance: Track portfolio growth and trading success

Traditional Use Cases

  • Sports Analytics: Real-time stats and rankings for professional leagues (e.g., NFL, NBA, MLB, NHL)
  • Education and E-learning: Track student progress and achievements in online courses
  • Fitness and Health Tracking: Monitor user rankings for steps taken, calories burned, or workout streaks
  • Sales and Marketing Performance: Showcase top performers or most effective marketing campaigns
  • Web Analytics: Real-time tracking of website metrics, user engagement, and content performance

Future support planned for additional blockchain ecosystems based on community demand

Web3 Storage with Walrus

Sui

LeaderPort products will use Walrus for decentralized storage of achievement data and related assets. Walrus is specifically designed for storing large binary files ("blobs") on the Sui network.

Key Features

  • Decentralized storage with Sui blockchain integration
  • Cost-efficient storage using advanced erasure coding
  • Public accessibility of stored data
  • Native WAL token integration for storage payments

Important Notes

  • All stored data is public and discoverable
  • Currently in Testnet phase - not recommended for production use
  • Uses Testnet WAL and SUI tokens (no real value)
  • Storage state may be wiped during Testnet

Potential Use Cases

  • Storing achievement badges/images
  • Backing up achievement metadata
  • Storing leaderboard historical data

Setup Requirements

  1. Testnet WAL tokens for storage operations
  2. Integration with Sui wallet for transactions
  3. Proper error handling for storage operations

Achievement Storage with Tusky.io

LeaderPort leverages Tusky's enhanced API layer over Walrus to provide a robust achievement and leaderboard storage solution. While Walrus handles the core decentralized storage, Tusky adds critical features that align with our platform needs:

Key Integration Benefits

  1. Structured Achievement Management

    • Organized file system for achievement badges and metadata
    • Hierarchical storage for different game/competition categories
    • Efficient bulk uploads for achievement batches
  2. Enhanced Security & Access Control

    • End-to-end encryption for private achievements
    • Vault-based access management for team leaderboards
    • Token-gated achievement collections (coming soon)
    • Magic link sharing for temporary leaderboard access
  3. Developer-Friendly Implementation

    • JavaScript SDK for seamless frontend integration
    • Webhook support for real-time achievement updates
    • CLI tools for bulk achievement management
    • Automated storage epoch management
  4. Performance Optimization

    • CDN-backed achievement asset delivery
    • Edge-optimized caching for leaderboard data
    • Chunked uploads for large achievement batches
    • Resumable uploads for reliable data transfer

Future Capabilities

  • NFT minting integration for achievement tokens
  • Long-term achievement storage through Epoch Vaults
  • Cross-chain achievement gating (Sui, Ethereum, Solana)
  • Crypto payment support for premium features

Why LeaderPort

As I explored this new idea during Christmas break, I needed a name. leaderport.io was available and it was close enough to what I was trying to build, perhaps even a bit too literal. It will work for now and we can always rebrand in the future if needed.

  • The "Port" in LeaderPort suggests both a gateway/portal and a place where important information docks/arrives
  • It serves as a central hub where different types of leadership data converge
  • Works across multiple domains:
    • Sports: "Track champions across every league"
    • Markets: "Monitor market movers and top performers"
    • Crypto: "Real-time crypto rankings and momentum"
    • Education: "Leadership boards for learning achievements"
    • Fitness: "Top performer tracking for health goals"
    • Business: "Sales leaderboards and performance metrics"

Product Description / Elevator Pitch

LeaderPort transforms your browser into a command center for real-time rankings. Whether you're tracking top-performing stocks, leading sports scores, trending cryptocurrencies, or competitive metrics, LeaderPort serves as your all-in-one portal to performance leadership. With customizable dashboards and instant updates, you'll always know what's leading the pack across any domain that matters to you.

Browser Extension Strategy

Our browser extensions will use public APIs the backend will provide real-time data visualization and insights.

  • Data Integration: Connects to LeaderPort's backend API which aggregates data from official sources
  • Smart Caching: Utilizes chrome.storage for data caching and user prefs, respecting subscription tiers
  • Interactive Visualization: Integrates Highcharts for professional-grade charts and dashboards
  • Real-time Updates: SSE/WebSocket connections for live data streaming based on subscription level
  • User Interface: Displays data in a chrome.sidePanel with progressive loading and offline support
  • Subscription Management: Handles user authentication and feature access based on subscription tier

For a detailed strategy and API integration details, refer to the Sports Data Integration Guide.

For development workflow, refer to Extension Development

Project Plan & Roadmap

The initial prototype will be launched as a browser extension in 2025, supporting Chrome, Firefox, and Safari. This MVP aims to ensure seamless functionality across all major browsers, providing a consistent user experience regardless of the platform.

If successful, work will continue towards developing a full-fledged SaaS platform. This will include additional features and enhancements based on user feedback and market demand, ensuring LeaderPort remains at the forefront of real-time leaderboard solutions.

For a detailed overview of our development phases, milestones, and future plans, please refer to the Roadmap.

Links

Core Documentation

Integration & Setup

State & Data Management

Technical Integration

Setup & Configuration

Future Expansion

In future iterations, we can expand this prototype with features like:

  • Player profiles
  • Multiple leaderboards
  • Time-based competitions

These additional features would further explore capabilities and showcase its versatility in game development scenarios. The leaderboard should be useful for game developers, hobbyists, and projects that require high-performance web applications.

View the public core, private premium repo setup doc for details on the open-source and paid feature strategy.

Support the Project

If you find LeaderPort valuable, consider supporting its development through SUI donations. Your contributions help maintain and improve this open-source project.

SUI Address:

0x9ad0d7ee1ebf1de8da2c9e817707b1d34f140bbbb0a75fe9b74dfbfdf0e4512d

GitHub Sponsors

You can also support LeaderPort's development through GitHub Sponsors. GitHub Sponsors allows you to make recurring monthly donations and receive sponsor-exclusive benefits.

Sponsor LeaderPort

License

This project is licensed under the Apache License, Version 2.0.

Copyright (c) 2024-present, Mike Delucchi :: Zanuka Labs

About

Elevating Heroes 🏁 🏁 🏁 🏁 🏁 Immortalizing Legends πŸ† πŸ† πŸ†

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published