borderlessbits.com

BorderlessBits.com

Professional cloud architecture and healthcare software consulting website with enterprise-grade CI/CD pipeline.

CI/CD Pipeline Security Scan Lighthouse Performance Uptime

🚀 Quick Start

Prerequisites

Local Development

# Clone repository
git clone https://github.com/username/borderlessbits.com.git
cd borderlessbits.com

# Install dependencies
npm install

# Setup environment
cp .env.example .env.local
# Edit .env.local with your configuration

# Start development server
npm run dev

Open http://localhost:3000 to view the application.

Docker Development

# Start with Docker Compose
docker-compose up

# Production preview
docker-compose --profile production up

🏗️ Architecture

Technology Stack

Zero-Cost Hosting Strategy

📋 Features

🎯 Core Features

🔒 Security Features

🚀 CI/CD Pipeline

🚦 Development Workflow

Branch Strategy

main           ← Production deployments (https://borderlessbits.com)
develop        ← Staging deployments (https://staging.borderlessbits.com)
feature/*      ← Preview deployments (https://preview-pr-{number}.netlify.app)
hotfix/*       ← Emergency production fixes

Available Scripts

Development:

npm run dev          # Start development server
npm run build        # Production build
npm run start        # Start production server
npm run preview      # Preview production build locally

Quality & Testing:

npm run lint         # Run ESLint
npm run lint:fix     # Fix ESLint issues
npm run type-check   # TypeScript validation
npm run format       # Format code with Prettier
npm run format:check # Check formatting
npm run test         # Run Jest tests
npm run test:coverage # Test coverage report
npm run validate-build # Full validation pipeline

Performance & Analysis:

npm run analyze      # Bundle analysis
npm run lighthouse   # Lighthouse audit
npm run lighthouse:ci # Lighthouse CI validation

Deployment:

./scripts/deploy.sh              # Deploy to production
./scripts/deploy.sh -e staging   # Deploy to staging
./scripts/deploy.sh -d           # Dry run deployment
./scripts/rollback.sh            # Emergency rollback
./scripts/rollback.sh -l         # List available backups

📁 Project Structure

├── .github/
│   ├── workflows/           # GitHub Actions CI/CD
│   │   ├── ci.yml          # Continuous Integration
│   │   ├── deploy-production.yml
│   │   ├── deploy-staging.yml
│   │   ├── preview-deploy.yml
│   │   ├── security-scan.yml
│   │   └── monitoring.yml
│   └── ISSUE_TEMPLATE/     # Issue templates
├── docs/                   # Documentation
│   ├── CI-CD-PIPELINE.md
│   ├── DEPLOYMENT-GUIDE.md
│   ├── SECURITY.md
│   └── ARCHITECTURE.md
├── scripts/                # Deployment scripts
│   ├── deploy.sh          # Main deployment script
│   ├── rollback.sh        # Rollback script
│   ├── setup-secrets.sh   # GitHub secrets setup
│   └── monitoring/
├── src/                   # Source code
│   ├── app/              # Next.js app directory
│   ├── components/       # React components
│   ├── lib/             # Utilities and libraries
│   ├── styles/          # Global styles
│   └── types/           # TypeScript definitions
├── src/                   # Source code
├── content/            # Markdown content
├── public/             # Static assets
├── docker/             # Docker configurations
├── next.config.js      # Next.js configuration
├── lighthouserc.json   # Lighthouse CI configuration
└── package.json        # Dependencies and scripts

🔧 Configuration

Environment Variables

Required for Production:

NEXT_PUBLIC_SITE_URL=https://borderlessbits.com
NEXT_PUBLIC_GA_MEASUREMENT_ID=G-XXXXXXXXXX
NEXT_PUBLIC_EMAILJS_SERVICE_ID=service_xxxxxxx
NEXT_PUBLIC_EMAILJS_TEMPLATE_ID=template_xxxxxxx
NEXT_PUBLIC_EMAILJS_PUBLIC_KEY=xxxxxxxxxx

Required for Deployment:

NETLIFY_AUTH_TOKEN=nfp_xxxxxxxxxx
NETLIFY_SITE_ID=xxxxxxxx-xxxx-xxxx-xxxx
GITHUB_TOKEN=ghp_xxxxxxxxxx

See .env.example for complete configuration options.

GitHub Secrets Setup

# Interactive setup
./scripts/setup-secrets.sh -t $GITHUB_TOKEN -r username/repository

# List current secrets
./scripts/setup-secrets.sh -t $GITHUB_TOKEN -r username/repository -l

Required GitHub Secrets:

🚀 Deployment

Automatic Deployment

Manual Deployment

# Deploy to all targets
./scripts/deploy.sh

# Deploy to specific environment
./scripts/deploy.sh -e staging -t netlify

# Force deployment (skip validations)
./scripts/deploy.sh -f

# Dry run (preview changes)
./scripts/deploy.sh -d

Rollback Procedures

# Emergency rollback
./scripts/rollback.sh -y

# List available backups
./scripts/rollback.sh -l

# Rollback to specific version
./scripts/rollback.sh -b backup-20231201-143022

📊 Monitoring

Health Monitoring

Performance Budgets

Monitoring Endpoints

🔒 Security

Security Features

Security Scanning

Incident Response

🧪 Testing

Test Types

Test Commands

npm run test              # Unit tests
npm run test:performance  # Performance tests
npm run test:security     # Security tests

Test Coverage

📚 Documentation

🤝 Contributing

  1. Fork the Repository
  2. Create Feature Branch: git checkout -b feature/amazing-feature
  3. Make Changes: Follow coding standards and add tests
  4. Run Quality Checks: npm run validate-build
  5. Commit Changes: git commit -m 'Add amazing feature'
  6. Push to Branch: git push origin feature/amazing-feature
  7. Open Pull Request: Include description and testing notes

Code Quality Standards

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

Documentation & Resources

Contact

Emergency Support

🌟 Acknowledgments

Built with ❤️ by Richard Mosley at BorderlessBits

📈 Status