Getting Started

🚀 Enterprise Setup: A+ Grade Arsenal Lab

🏆 Welcome to A+ Grade Enterprise Solution! This comprehensive guide gets you running the production-ready Arsenal Lab in under 10 minutes. Whether you're evaluating enterprise performance tools or deploying for production, this guide covers full-stack enterprise setup.

📋 Prerequisites

Before we begin, ensure you have:

• Bun Runtime: >=1.3.0 (Install Bun)
• Git: For cloning repositories
• Modern Browser: Chrome 90+, Firefox 88+, or Safari 14+

# Check your Bun version
bun --version  # Should show 1.3.x or higher

🏆 Enterprise Installation Options

Option 1: Full-Stack Enterprise Setup (Recommended)

# Clone the A+ grade enterprise repository
git clone https://github.com/brendadeeznuts1111/Arsenal-Lab.git
cd Arsenal-Lab

# Install all dependencies (frontend + backend)
bun install

# Setup enterprise backend infrastructure
bun run backend:migrate

# Start full-stack enterprise environment
bun run fullstack:dev

Access Points:

• 🏆 A+ Grade Frontend: http://localhost:3655 (Complete enterprise UI)
• 🔧 RESTful Backend API: http://localhost:3001 (Enterprise-grade APIs)
• 📊 Analytics Dashboard: Real-time performance monitoring
• ☁️ Cloud Features: Persistent storage and remote builds

🎉 Enterprise deployment complete! You're now running the A+ grade solution.

Option 2: Frontend-Only Enterprise Demo

# Clone and run frontend with simulated backend
git clone https://github.com/brendadeeznuts1111/Arsenal-Lab.git
cd Arsenal-Lab

# Install frontend dependencies only
bun install

# Start enterprise frontend (backend features simulated)
bun run dev

Then open: http://localhost:3655

Option 3: Standalone Enterprise Preview (No Installation Required)

# Enterprise evaluation without any setup
git clone https://github.com/brendadeeznuts1111/Arsenal-Lab.git
cd Arsenal-Lab/public

# Open enterprise preview - works completely offline
open arsenal-lab.html

Features Available:

• ✅ A+ Grade UI with enterprise branding
• ✅ Complete arsenal demonstrations
• ✅ Performance metrics showcase
• ✅ Enterprise feature previews

Option 3: NPM Package (For integration)

# Install as a dependency in your project
bun add @bun/performance-arsenal

# Or globally for CLI access
bun add -g @bun/performance-arsenal

🎯 First Steps

1. Explore the Interface

When you first load Arsenal Lab, you'll see five main arsenals:

• ⚡ Performance Arsenal: Benchmark Bun vs Node.js
• 🗄️ Database Infrastructure: Test SQLite & Redis
• 🔧 Build Configuration: Interactive Bun.build() playground
• 🧪 Testing Arsenal: Comprehensive testing tools
• 📊 Process & Shell: System-level testing

2. Run Your First Benchmark

# Using the CLI
bun arsenal:benchmark

# Or through the web interface
# 1. Click "Performance Arsenal"
# 2. Select a benchmark (try "Crypto")
# 3. Click "Run Benchmark"

3. View Analytics

# Enable real-time analytics
bun arsenal:lab --analytics

# View performance metrics in your browser
open http://localhost:3655

💡 Key Concepts

Understanding Arsenal Lab

Arsenal Lab is organized around five specialized testing environments:

⚡ Performance Arsenal

• Real-time benchmarking of Bun vs Node.js
• Hardware detection and optimization
• Custom benchmark creation capabilities

🗄️ Database Infrastructure Arsenal

• SQLite performance testing with in-memory databases
• Redis integration and caching benchmarks
• Cloud storage simulation (S3-compatible)

🔧 Build Configuration Arsenal

• Interactive Bun.build() API playground
• CLI command generation and testing
• Bundle optimization tools

🧪 Testing Arsenal

• Concurrent test execution
• Mock data generation
• CI/CD integration examples

📊 Process & Shell Arsenal

• Socket communication testing
• Process management and monitoring
• Memory and stream analysis

🏃‍♂️ Quick Examples

Basic Benchmarking

import { PerformanceArsenal } from '@bun/performance-arsenal';

// Quick performance comparison
const results = await PerformanceArsenal.runBenchmark('crypto', {
  iterations: 1000,
  compareWithNode: true
});

console.log(`Bun: ${results.bun}ms, Node: ${results.node}ms`);
console.log(`Speedup: ${results.speedup}x`);

Database Testing

import { DatabaseInfrastructureArsenal } from '@bun/performance-arsenal';

// Test SQLite performance
const db = new DatabaseInfrastructureArsenal.Database();

await db.connect(':memory:');
await db.benchmarkBulkInsert(10000);
const metrics = db.getMetrics();

console.log(`Insert rate: ${metrics.insertsPerSecond} ops/sec`);

Build Configuration

import { BuildConfigurationArsenal } from '@bun/performance-arsenal';

// Generate optimized build config
const config = BuildConfigurationArsenal.generateConfig({
  entrypoints: ['./src/index.ts'],
  target: 'browser',
  minify: true,
  sourcemap: 'external'
});

// Get CLI command
const cliCommand = config.toCLI();
console.log(cliCommand); // bun build ./src/index.ts --target=browser --minify --sourcemap=external

🔧 Configuration

Environment Variables

# Set analytics preferences
export ARSENAL_ANALYTICS_ENABLED=true
export ARSENAL_ANALYTICS_RETENTION=30d

# Configure hardware detection
export ARSENAL_HARDWARE_DETECTION=true
export ARSENAL_LOW_FPS_THRESHOLD=30

# Database settings
export ARSENAL_SQLITE_PATH=:memory:
export ARSENAL_REDIS_URL=redis://localhost:6379

Configuration File

Create arsenal.config.json:

{
  "analytics": {
    "enabled": true,
    "retention": "30-days",
    "exportPath": "./analytics"
  },
  "performance": {
    "hardwareDetection": true,
    "fpsThreshold": 30,
    "memoryThreshold": 500
  },
  "database": {
    "sqlite": { "path": ":memory:" },
    "redis": { "url": "redis://localhost:6379" }
  },
  "build": {
    "defaultTarget": "browser",
    "minify": true,
    "sourcemap": "external"
  }
}

🚨 Troubleshooting

Common Issues

"Command not found: bun"

# Install Bun
curl -fsSL https://bun.sh/install | bash

# Restart your terminal
exec $SHELL

"Port 3655 already in use"

# Use a different port
bun run dev --port 3000

# Or find what's using the port
lsof -i :3655
kill -9 <PID>

"Performance benchmarks not working"

# Check Node.js installation
node --version

# Ensure clean system state
# Close background applications
# Restart Arsenal Lab
bun run dev --fresh

"Database connection failed"

# For SQLite - use in-memory database
export ARSENAL_SQLITE_PATH=:memory:

# For Redis - ensure Redis is running
redis-server --daemonize yes
redis-cli ping  # Should return PONG

📚 Next Steps

Now that you're set up, explore these resources:

🎯 Hands-on Tutorials

• Performance Testing Tutorial - Learn benchmarking
• Database Integration Guide - Master data testing
• Build Optimization - Optimize your builds

📖 Advanced Topics

• Analytics & Monitoring - Deep dive into metrics
• API Reference - Complete technical docs
• Integration Examples - Framework integration

🤝 Community

• GitHub Discussions - Ask questions
• Issues - Report bugs
• Contributing Guide - Help improve Arsenal Lab

🎉 You're All Set!

You've successfully installed and configured Arsenal Lab! Here's a quick checklist:

• ✅ Bun runtime installed
• ✅ Arsenal Lab running
• ✅ Basic benchmark executed
• ✅ Analytics configured
• ✅ Documentation explored

Ready to dive deeper? Head to the Performance Arsenal Tutorial to learn advanced benchmarking techniques.

---

Need help? Join our GitHub Discussions or check the Troubleshooting Guide.

Built with ❤️ for the Bun ecosystem • Last updated: October 21, 2025