Changelog & Breaking Changes

v0.3.5 - Complete SSL/HTTPS Support & 100% Service Reliability

Released on August 15, 2025

✨ Major Release: Production-Ready Backend in Under 5 Minutes

This release delivers on the core promise of nself: a completely reliable, SSL-enabled backend infrastructure that just works.

πŸ” Complete SSL/HTTPS Support

  • Automatic SSL Certificates: All services now use HTTPS by default with green lock browser compatibility
  • Dual Domain Support: Both *.localhost and *.local.nself.org domains with trusted certificates
  • New SSL Commands:
    • nself trust - Install root CA certificates and enable browser trust
    • nself trust status - Check SSL trust status
    • nself ssl bootstrap - Bootstrap SSL certificates
    • nself ssl renew - Renew public certificates (Let's Encrypt)
    • nself ssl status - Check SSL certificate status
  • Cross-Platform Support: SSL setup works on macOS, Windows, and Linux
  • Production Ready: Let's Encrypt integration for production deployments

πŸš€ 100% Service Reliability

  • Perfect Success Rate: All 17/17 services now start successfully every time
  • Volume Mount Fixes: Resolved critical Docker volume mounting issues that caused service failures
  • Enhanced Dependency Management: Improved service startup order and dependency resolution
  • Node.js Module Loading: Fixed module resolution and loading performance issues
  • Auto-Recovery: Enhanced health monitoring with automatic service recovery

🎯 Smart Port Allocation

  • Organized Port Management: 3000-3099 reserved for frontend applications
  • System Services: 3100+ range for system services (Adminer: 3100, MailPit: 3101)
  • Conflict Prevention: Smart allocation prevents port conflicts in development
  • Network Compatibility: Better organization for team development environments

✨ Enhanced Development Experience

  • MailPit Integration: Enhanced email testing with better HTML rendering and mobile interface
  • Green Lock Development: Professional HTTPS setup for local development
  • Dual Access Methods: Choose between localhost domains (fastest) or network domains (team access)
  • Zero Configuration: SSL and service reliability work out of the box

πŸ”§ Bug Fixes & Improvements

  • Fixed critical volume mounting issues that prevented services from starting
  • Resolved Node.js module loading and resolution problems
  • Enhanced service health checking and monitoring
  • Improved error handling and recovery mechanisms
  • Better SSL certificate validation and troubleshooting
  • Enhanced cross-platform compatibility for SSL setup

πŸ“š Documentation Updates

  • Complete SSL/HTTPS documentation with practical examples
  • Updated all CLI command references with new SSL commands
  • Enhanced troubleshooting guides with v0.3.5 fixes
  • Improved architecture documentation with reliability details
  • Updated Quick Start guide with SSL setup instructions

⚠️ Breaking Changes

  • SSL by Default: All services now use HTTPS when certificates are available
  • Port Changes: Some system services moved to 3100+ range for better organization
  • MailPit Replaces MailHog: Enhanced email testing with new interface (automatic migration)

πŸ”„ Migration Guide

To upgrade from v0.3.4 to v0.3.5:

  1. Update nself: nself update
  2. Rebuild your project: nself build
  3. Start services: nself up
  4. Enable SSL trust: nself trust (recommended)
  5. Update any hardcoded port references to new smart allocation scheme

v0.3.4 - Standardized Headers & Improved Stability

Released on August 14, 2025

New Features

  • Standardized command headers with consistent blue borders across all commands
  • Bold command titles with dim descriptive subtitles for better visual hierarchy
  • Centralized show_command_header function for uniformity
  • Clean, boxed design that enhances the terminal experience

Bug Fixes

  • Fixed extra spacing after title and subtitle lines in headers
  • Fixed color rendering in non-TTY environments
  • Corrected nself up header positioning to display before pre-flight checks
  • Fixed nself down using direct docker ps for accurate container detection
  • Resolved false "stopped" status for actively running containers
  • Fixed integer comparison syntax errors in comprehensive.sh
  • Cleaned grep output to prevent multi-line variable issues
  • Fixed nginx storage service port mismatch (5000 β†’ 5001)
  • Updated all nginx configs to use modern http2 on; directive

Improvements

  • Consistent output standards across all commands
  • Better visual hierarchy with standardized spacing
  • Enhanced reliability in auto-fix system
  • Proper color support in all terminal environments

v0.3.3 - Intelligent Auto-Fix System

Released on August 14, 2025

Major New Features

  • Auto-Fix Now Default: ALWAYS_AUTOFIX=true is the new default behavior
  • New `nself clean` Command: Clean up Docker resources with surgical precision
  • Service Auto-Generation: Missing services are created automatically
  • Advanced Port Conflict Resolution: Proactive port checking before Docker starts

Build System Enhancements

  • Silent failures now properly report errors
  • Fully idempotent build command
  • Graceful handling of partial builds
  • Validation runs in isolated subshell

Service Reliability

  • Automatic recovery from unhealthy services
  • Missing Dockerfile detection and generation
  • Go module dependency auto-resolution
  • Continuous retry mechanism (up to 30 attempts)

Professional Output

  • Lowercase headers following nself design standards
  • Compact status indicators (βœ“, ⚑, β ‹, βœ—)
  • Cleaner, more readable terminal output
  • CI/CD-friendly verbose reduction

v0.3.2 - Critical Command Resolution Fixes

Released on August 12, 2025

Critical Fixes

  • Fixed critical command resolution issues that prevented commands from executing properly
  • Resolved SCRIPT_DIR corruption and path resolution problems
  • Improved command routing reliability across all CLI functions
  • Enhanced install script banner and version display
  • All 19 documented commands are now fully functional

Installation Improvements

  • Better error handling during installation process
  • Improved feedback for installation status
  • More robust script directory management

v0.3.1 - Enhanced Configuration Validation

Released on August 12, 2025

Configuration Management

  • Added 25+ comprehensive validation checks for .env files
  • Implemented smart auto-fix system for common configuration errors
  • Professional output formatting with clean, aligned messages
  • Enhanced environment file priority handling

Advanced Validations

  • IP address validation and formatting
  • SSL configuration validation
  • Timezone validation
  • Service list validation
  • Cross-platform compatibility improvements

User Experience

  • Automatic detection and fixing of empty configuration files
  • Invalid port detection and correction
  • Password validation and security checks
  • Detailed error reporting with actionable suggestions

v0.3.0 - Major Architecture Refactor

Released on January 11, 2025

⚠️ Breaking Changes

This is a major architectural update that requires careful migration. The entire codebase has been refactored from a monolithic structure to a modular src-centric architecture.

Migration Guide

If you're upgrading from v0.2.x to v0.3.0, follow these steps:

  1. Backup your data first:
    nself db backup
  2. Update to v0.3.0:
    nself update
  3. Run the doctor command to check system health:
    nself doctor
  4. Rebuild your project:
    nself build

Breaking Changes

  • Architecture Changes:
    • Complete refactor from monolithic to modular src-centric architecture
    • All code now lives in /src with organized subdirectories
    • /bin directory now contains only thin shim scripts
    • Templates, certificates, and libraries moved to /src
  • Build System:
    • Monolithic build.sh broken down into maintainable modules
    • Separate modules for environment, Docker, services, nginx, SSL, and Hasura

New Features

  • Comprehensive Error Handling System:
    • Modular error detection and reporting
    • Auto-fix capabilities for common issues
    • Interactive user prompts for resolution
    • Port conflict resolution
    • Docker build error analysis
    • Go module and Node.js build error handling
  • Enhanced Doctor Command:
    • System health checks
    • Environment validation
    • Service connectivity testing
    • Auto-fix suggestions
  • Real-time Status Monitoring:
    • Service health monitoring
    • Color-coded status indicators
    • Improved log filtering

Bug Fixes

  • Fixed installation upgrade path from v0.2.x
  • Full bash 3.2 compatibility for macOS
  • Improved port conflict detection
  • Fixed Go module build errors
  • Corrected template path references
  • Added safety checks for repository detection
  • Standardized shebangs across all scripts

Improvements

  • Performance optimizations throughout
  • Docker Desktop auto-start on macOS
  • More interactive configuration process
  • More descriptive error messages
  • More resilient build process
  • Improved version detection

v0.2.4 - Complete Email Management

Released on January 9, 2025

Features

  • Zero-config development email with MailPit
  • Support for 16+ email providers (SendGrid, AWS SES, Mailgun, etc.)
  • Interactive setup wizard with nself email setup
  • Smart provider detection based on environment variables

v0.2.3 - SSL Trust & Developer Experience

Released on January 9, 2025

Features

  • Automatic SSL trust using mkcert
  • Nhost Dashboard access with trusted certificates
  • New nself trust command
  • New nself diff command
  • Experimental hot reload system

Bug Fixes

  • Fixed JWT secret parsing issues
  • Resolved environment variable problems
  • Fixed service port configuration

v0.2.2 - Seamless Updates

Released on January 8, 2025

Features

  • One-command updates with nself update
  • Smart installation detection
  • Enhanced CLI with loading animations
  • Automatic rollback on failure
  • Network resilience improvements

For older versions, see the full changelog on GitHub.