Biohacker Red Team

The Complete Biohackers Manual - Disease Hacking & Biological Threat Hunting Protocols.

🚀 Quick Start

Local Development

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

# Start production server
npm start

Docker Deployment

# Build and run with Docker Compose
docker-compose up -d

# Access the application
http://localhost:5000

🔄 CI/CD with GitHub Actions

This project includes automated workflows for building and deployment.

Automated Workflows

1. CI/CD Pipeline (.github/workflows/ci-cd.yml)

   • ✅ Automated testing on push/PR
   • ✅ Docker image building
   • ✅ Publish to GitHub Container Registry

2. GitHub Pages Deployment (.github/workflows/deploy-pages.yml)

   • ✅ Static site deployment
   • ✅ Automatic updates on push to main

Setup Instructions

1. Enable GitHub Actions:

   • Go to repository Settings > Actions
   • Enable Actions and select workflows

2. Configure GitHub Pages:

   • Settings > Pages > Source = GitHub Actions
   • Site will deploy to: https://[username].github.io/biohacker-red-team

3. Environment Variables (optional):

   # Copy example environment file
   cp .env.example .env
   
   # Edit with your values
   # DATABASE_URL, API keys, etc.

Deployment Options

Option 1: GitHub Container Registry (Docker)

# Pull the image
docker pull ghcr.io/okelano/biohacker-red-team:latest

# Run the container
docker run -p 5000:5000 ghcr.io/okelano/biohacker-red-team:latest

Option 2: GitHub Pages (Static)

• Automatic deployment on every push to main
• No server required
• Limited to frontend functionality

Option 3: Custom Deployment

# Build locally
npm run build

# Deploy dist/ folder to your hosting provider

🛠️ Technology Stack

• Frontend: React 19, Vite, TailwindCSS
• Backend: Express.js, TypeScript
• Database: PostgreSQL with Drizzle ORM
• Authentication: Passport.js
• Deployment: Docker, GitHub Actions

📁 Project Structure

├── client/          # React frontend
├── server/          # Express backend
├── shared/          # Shared utilities
├── script/          # Build scripts
├── .github/         # GitHub Actions workflows
├── docker-compose.yml
├── Dockerfile
└── package.json

🔧 Configuration

Environment Variables

See .env.example for available configuration options.

Database Setup

# Push database schema
npm run db:push

# View database configuration
cat drizzle.config.ts

📊 Monitoring

Health Checks

• Application: GET /api/health
• Container: Built-in Docker health checks
• GitHub Actions: Workflow status in Actions tab

Logs

# Docker logs
docker-compose logs app

# Application logs
# Check server console for API requests

🤝 Contributing

1. Fork the repository
2. Create feature branch
3. Push changes
4. Open Pull Request

GitHub Actions will automatically:

• Run tests
• Build application
• Deploy on merge to main

📝 License

MIT License - see LICENSE file for details.