Skip to content

Maa-ly/PULLEY

Repository files navigation

Prediction Market Simulation Platform

A sophisticated Next.js-based prediction market simulation platform that allows users to practice trading with virtual funds, analyze market patterns, and build confidence before risking real capital in prediction markets.

๐ŸŽฏ Project Overview

This platform provides a risk-free environment for users to master prediction trading through advanced simulation features, real-time market data, and comprehensive analytics. Built with modern web technologies and blockchain integration, it offers a complete trading experience without financial risk.

โœจ Key Features

๐ŸŽฎ Simulation Trading

  • Virtual Portfolio Management: Practice with $50K virtual funds
  • Risk-Free Learning: Test strategies without financial consequences
  • Real-Time Market Data: Access live prediction market information
  • Performance Tracking: Monitor accuracy rates and trading success

๐Ÿ“Š Advanced Analytics

  • Prediction Accuracy Tracking: Monitor success rates (87% average)
  • Portfolio Performance: Real-time virtual profit/loss tracking
  • Market Analysis: AI-powered market insights and trends
  • Historical Data: Comprehensive trading history and analytics

๐Ÿ”— Blockchain Integration

  • Particle Network ConnectKit: Seamless wallet connectivity
  • Multi-Chain Support: Core DAO, Core Testnet, Solana
  • Social Login: Email, Google, Apple, Twitter, GitHub authentication
  • Universal Account SDK: Advanced wallet management

๐ŸŽจ Modern UI/UX

  • Dark Theme Design: Professional crypto-focused interface
  • Responsive Layout: Optimized for all device sizes
  • Interactive Charts: Real-time data visualization
  • Smooth Animations: Enhanced user experience

๐Ÿ› ๏ธ Technology Stack

Frontend Framework

  • Next.js 15.3.5: React framework with App Router
  • React 19: Latest React features and performance
  • TypeScript: Type-safe development
  • Tailwind CSS 4: Modern utility-first CSS framework

UI Components

  • Radix UI: Accessible component primitives
  • Lucide React: Beautiful icon library
  • Recharts: Data visualization components
  • Sonner: Toast notifications

Blockchain & Web3

  • Particle Network: Wallet connectivity and authentication
  • Ethers.js: Ethereum interaction
  • Viem: Type-safe Ethereum interactions
  • React Query: Data fetching and caching

Development Tools

  • ESLint: Code linting and formatting
  • pnpm: Fast package management
  • Turbopack: Next.js bundler for development

๐Ÿš€ Getting Started

Prerequisites

  • Node.js 18+
  • pnpm (recommended) or npm
  • Particle Network account and API keys

Environment Setup

Create a .env.local file in the root directory:

NEXT_PUBLIC_PROJECT_ID=your_particle_project_id
NEXT_PUBLIC_CLIENT_KEY=your_particle_client_key
NEXT_PUBLIC_APP_ID=your_particle_app_id

Installation

  1. Clone the repository

    git clone https://github.com/ctib-core/frontend.git
    cd frontend
  2. Install dependencies

    pnpm install
    # or
    npm install
  3. Run the development server

    pnpm dev
    # or
    npm run dev
  4. Open your browser Navigate to http://localhost:3000

๐Ÿ“ Project Structure

frontend/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ app/                    # Next.js App Router
โ”‚   โ”‚   โ”œโ”€โ”€ app/               # Main application pages
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ markets/       # Market trading interface
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ portfolio/     # Portfolio dashboard
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ trading/       # Trading interface
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ wallet/        # Wallet management
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ vaults/        # Vault features
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ swap/          # Token swapping
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ ui/            # UI component examples
โ”‚   โ”‚   โ”œโ”€โ”€ globals.css        # Global styles
โ”‚   โ”‚   โ”œโ”€โ”€ layout.tsx         # Root layout
โ”‚   โ”‚   โ””โ”€โ”€ page.tsx           # Landing page
โ”‚   โ”œโ”€โ”€ components/            # Reusable components
โ”‚   โ”‚   โ”œโ”€โ”€ ui/               # Base UI components
โ”‚   โ”‚   โ”œโ”€โ”€ cryptoHub.tsx     # Market hub component
โ”‚   โ”‚   โ”œโ”€โ”€ hero.tsx          # Landing hero section
โ”‚   โ”‚   โ”œโ”€โ”€ sidebar.tsx       # Navigation sidebar
โ”‚   โ”‚   โ””โ”€โ”€ portfolioDashboard.tsx # Portfolio interface
โ”‚   โ”œโ”€โ”€ lib/                  # Utility libraries
โ”‚   โ”‚   โ”œโ”€โ”€ particle.tsx      # Particle Network config
โ”‚   โ”‚   โ””โ”€โ”€ utils.ts          # Utility functions
โ”‚   โ””โ”€โ”€ utils/                # Type definitions
โ”œโ”€โ”€ public/                   # Static assets
โ”œโ”€โ”€ package.json              # Dependencies and scripts
โ””โ”€โ”€ README.md                # Project documentation

๐ŸŽฎ Available Features

Landing Page (/)

  • Hero section with platform introduction
  • Feature showcase with simulation benefits
  • Live prediction markets display
  • Call-to-action sections

Main Application (/app)

  • Portfolio Dashboard: Virtual portfolio management
  • Markets: Live prediction market trading
  • Trading Interface: Advanced trading tools
  • Wallet Management: Secure wallet connectivity
  • Vaults: Yield farming and staking
  • Swap: Token exchange functionality

UI Components (/app/ui)

  • Menu styles and navigation
  • Data tables and forms
  • Chart components and modals
  • Pricing and settings interfaces

๐Ÿ”ง Development Scripts

# Development server with Turbopack
pnpm dev

# Production build
pnpm build

# Start production server
pnpm start

# Lint code
pnpm lint

๐ŸŽจ Design System

Color Palette

  • Primary: #b6ff3b (Neon Green)
  • Background: #0a0f1a (Dark Blue)
  • Card: rgba(16,20,26,0.85) (Semi-transparent)
  • Border: #23272f (Dark Gray)
  • Text: #f1f5f9 (Light Gray)

Typography

  • Font Family: Geist Sans (Primary), Geist Mono (Code)
  • Responsive Design: Mobile-first approach
  • Custom Scrollbars: Styled for dark theme

๐Ÿ” Security Features

  • Particle Network Integration: Secure wallet authentication
  • Environment Variables: Secure API key management
  • TypeScript: Type-safe development
  • ESLint: Code quality and security checks

๐Ÿ“ˆ Performance Optimizations

  • Next.js 15: Latest performance features
  • Turbopack: Fast development bundling
  • Image Optimization: Next.js built-in optimization
  • Code Splitting: Automatic route-based splitting
  • React Query: Efficient data fetching and caching

๐Ÿค Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

๐Ÿ“ License

This project is part of the CTIB Core ecosystem. Please refer to the project maintainers for licensing information.

๐Ÿ”— Links

๐Ÿ†˜ Support

For support and questions:

  • Create an issue in the GitHub repository
  • Check the documentation in /app/documentation
  • Contact the development team

Built with โค๏ธ using Next.js, React, and Particle Network

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •