Skip to content

market sentiment tracking platform that allows communities to express conviction in cryptocurrencies through a pump-based voting system, with time-based filtering and EXPL point rewards for meaningful engagement.

License

Notifications You must be signed in to change notification settings

explorills/expl-one-pump

Repository files navigation

ONE Ecosystem - expl.one

ONE pump is part of the ONE Ecosystem // powered by EXPL Nodes

ONE Pump

A cryptocurrency sentiment tracking application where users vote on coins through daily pumps, earn points, and maintain streaks.

Features

Voting System

  • One pump per user per day
  • View pump counts filtered by time period (daily, weekly, monthly, yearly, all-time)
  • Add new cryptocurrencies to the voting list

Points System

  • Earn 10 EXPL points for each daily pump
  • Earn 100 EXPL points for adding a new coin
  • Global leaderboard ranking by total points

Streaks

  • Track consecutive days of pumping
  • Streak freeze: spend 50 EXPL to protect your streak
  • Streak challenges: bet EXPL points on maintaining streak goals

User Profile

  • View personal pump history
  • See coins you've added
  • Track rank and point balance

Technology Stack

  • Frontend: React 19, TypeScript
  • Build Tool: Bun, Vite
  • Styling: Tailwind CSS
  • UI Components: Shadcn UI
  • Animations: Framer Motion
  • Icons: Phosphor Icons
  • Notifications: Sonner
  • Storage: localStorage (client-side)

Project Structure

src/
├── App.tsx                 # Main application
├── components/
│   ├── ui/                 # Shadcn UI components
│   ├── Header.tsx          # Navigation bar
│   ├── Footer.tsx          # Footer
│   ├── CoinTable.tsx       # Desktop coin list
│   ├── CoinCardList.tsx    # Mobile coin list
│   ├── PumpButton.tsx      # Hold-to-pump interaction
│   ├── TimeframeFilter.tsx # Time period selector
│   ├── StatsBanner.tsx     # Platform statistics
│   ├── ImpactMeter.tsx     # Collective impact visualization
│   ├── AddCoinDialog.tsx   # Add cryptocurrency modal
│   ├── CoinDetailsDialog.tsx
│   ├── LeaderboardDialog.tsx
│   ├── UserProfileDialog.tsx
│   ├── StreakDialog.tsx
│   ├── RulesDialog.tsx
│   ├── LeaderboardButton.tsx
│   ├── RulesButton.tsx
│   └── FullScreenRocketAnimation.tsx
├── hooks/
│   ├── useLocalStorage.ts  # Temporary state persistence
│   └── use-mobile.ts       # Responsive breakpoint detection
├── lib/
│   ├── types.ts            # TypeScript definitions
│   ├── helpers.ts          # Utility functions
│   ├── sound.ts            # Audio effects
│   └── utils.ts            # Shadcn utilities
└── index.css               # Theme configuration

Development

Prerequisites

Setup

# Install Bun (if not already installed)
curl -fsSL https://bun.sh/install | bash

# Install dependencies (30x faster than npm!)
bun install

# Start development server
bun dev
# or
bun start

# Build for production
bun run build

# Build optimized production bundle
bun run build:production

# Type checking
bun run type-check

# Lint
bun run lint

# Preview production build
bun run preview

License

MIT


ONE Ecosystem - expl.one

ONE pump is part of the ONE Ecosystem // powered by EXPL Nodes

About

market sentiment tracking platform that allows communities to express conviction in cryptocurrencies through a pump-based voting system, with time-based filtering and EXPL point rewards for meaningful engagement.

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published