Minebench UI - Mining Benchmark Dashboard

A comprehensive Next.js dashboard for mining benchmark results with performance analytics, built for deployment on Akash Network.

🚀 Features

• Real-time Benchmark Data: Display mining performance metrics including hashrate, power consumption, efficiency, and temperature
• Interactive Tables: Sortable and filterable results with search functionality
• Performance Analytics: Statistical summaries and trend analysis
• Export Capabilities: CSV export for data analysis
• Responsive Design: Modern UI with Tailwind CSS
• Docker Ready: Optimized for containerized deployment
• Akash Compatible: Ready for decentralized cloud deployment

🛠️ Tech Stack

• Framework: Next.js 14 with App Router
• Language: TypeScript
• Styling: Tailwind CSS
• Icons: Lucide React
• Deployment: Docker + Akash Network

🚀 Quick Start

For GitHub + Akash Deployment (Recommended)

1. Fork this repository
2. Update deploy.yml with your GitHub username
3. Push to GitHub - Actions will build automatically
4. Make package public in GitHub Packages
5. Run deployment script:

   ./deploy-to-akash.sh

For Local Development

npm install
npm run dev
# Open http://localhost:3000

📦 Installation

Prerequisites

• Node.js 18+
• npm or yarn
• Docker (for containerized deployment)

Local Development

1. Clone the repository

   git clone <repository-url>
   cd minebench-ui

2. Install dependencies

   npm install

3. Run development server

   npm run dev

4. Open in browser Navigate to http://localhost:3000

Build for Production

npm run build
npm start

🐳 Docker Deployment

Build Docker Image

docker build -t minebench-ui .

Run Container

docker run -p 3000:3000 minebench-ui

Using Docker Compose

docker-compose up -d

🌐 GitHub Container Registry & Akash Deployment

Prerequisites

1. GitHub Account with repository
2. Akash CLI installed
3. AKT tokens for deployment costs

Option 1: Automated GitHub Actions (Recommended)

1. Push to GitHub

   git add .
   git commit -m "Initial commit"
   git push origin main

2. GitHub Actions will automatically:

   • Build Docker image
   • Push to GitHub Container Registry
   • Generate Akash deployment file

3. Make image public:

   • Go to your GitHub repository → Packages
   • Find minebench-ui package
   • Make it public in package settings

4. Deploy to Akash:

   # Use automated script
   ./deploy-to-akash.sh
   
   # Or Windows PowerShell
   .\deploy-to-akash.ps1

Option 2: Manual Build and Push

1. Create GitHub Personal Access Token

   • Go to GitHub Settings → Developer settings → Personal access tokens
   • Create token with write:packages scope

2. Build and push manually:

   # Linux/macOS
   ./build-and-push.sh
   
   # Windows PowerShell
   .\build-and-push.ps1

3. Update deploy.yml:

   services:
     minebench-ui:
       image: ghcr.io/YOUR_USERNAME/minebench-ui:latest

4. Deploy to Akash:

   akash tx deployment create deploy.yml --from your-key --fees 5000uakt

Akash Configuration

The deploy.yml file is configured for:

• CPU: 0.5 units
• Memory: 512Mi
• Storage: 1Gi
• Port: 3000 (exposed as port 80)
• Pricing: 1000 uakt per block

📊 Data Structure

Benchmark Result Interface

interface BenchmarkResult {
  id: string;
  timestamp: string;
  algorithm: string;
  hashrate: number;
  powerConsumption: number;
  efficiency: number;
  temperature: number;
  gpuModel: string;
  driverVersion: string;
  os: string;
  miner: string;
  pool: string;
  difficulty: number;
  shares: {
    accepted: number;
    rejected: number;
    stale: number;
  };
  uptime: number;
  profitability: number;
}

🎨 Customization

Adding New Metrics

1. Update the BenchmarkResult interface in types/benchmark.ts
2. Add formatting functions in lib/utils.ts
3. Update table columns in components/BenchmarkTable.tsx

Styling

The app uses Tailwind CSS with custom mining-themed colors:

• Primary: Blue gradient
• Mining: Yellow/Gold gradient
• Custom utilities in app/globals.css

Mock Data

Currently uses generated mock data. To connect to real data:

1. Replace generateMockData() calls with API calls
2. Update data fetching in app/page.tsx
3. Add error handling and loading states

🔧 Configuration

Environment Variables

• NODE_ENV: Production/development mode
• PORT: Server port (default: 3000)
• HOSTNAME: Server hostname (default: 0.0.0.0)

Next.js Configuration

The app is configured with:

• Standalone output for Docker optimization
• App Router enabled
• Image optimization disabled for static deployment

📈 Performance

• Bundle Size: Optimized with Next.js standalone output
• Loading: Lazy loading and code splitting
• Caching: Static generation where possible
• Responsive: Mobile-first design

🚀 Production Checklist

• Update image registry in deploy.yml
• Configure environment variables
• Set up monitoring and logging
• Configure SSL/TLS certificates
• Set up backup strategies
• Configure scaling policies

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

📄 License

This project is licensed under the MIT License.

🆘 Support

For issues and questions:

• Create an issue in the repository
• Check the documentation
• Review the Akash deployment guide

🔗 Links

• Next.js Documentation
• Tailwind CSS
• Akash Network
• Docker Documentation

---

Ready for Akash deployment 🚀