Changelog & Breaking Changes

v0.4.8 - Plugin System

Released on January 24, 2026

New Commands

Available Plugins

• Stripe (v1.2.0): Payment processing, subscriptions, invoices, revenue analytics
• GitHub (v1.3.0): Repository sync, issues, PRs, Actions, workflow statistics
• Shopify (v1.1.0): Products, orders, customers, inventory, sales analytics

Plugin Features

• Database Schemas: Plugins create prefixed tables automatically tracked in Hasura
• Webhook Handlers: Real-time event processing with signature verification
• CLI Actions: Plugin-specific commands (nself plugin stripe sync)
• Plugin Registry: Central registry at plugins.nself.org with global edge distribution

No Breaking Changes

• Fully Backward Compatible: All v0.4.7 projects work without modification

Update Instructions

To upgrade from v0.4.7 to v0.4.8:

1. Update nself: nself update
2. Install your first plugin: nself plugin install stripe

v0.4.7 - QA Complete Release

Released on January 23, 2026

New Commands

Key Fixes

• Bash 3.2 Compatible: No declare -A usage, works everywhere
• Path Resolution Fixed: No hardcoded developer paths in production
• Environment Diff: Proper output and exit codes
• Mock Data Generation: Respects VARCHAR limits

v0.4.2 - Service & Monitoring Management

Released on January 22, 2026

✨ New Commands

🔧 Technical Improvements

• SSL Certificate Generation: Now dynamically includes BASE_DOMAIN and wildcards
• User-Agent Header Forwarding: nginx proxy configs now forward User-Agent for backend services
• Cross-Platform Compatibility: All commands use printf instead of echo -e, safe_sed_inline wrapper

📋 Testing

• 92 Unit Tests: New test suite covering all 6 service commands
• Cross-Platform Verified: Tested on Ubuntu 22.04 and macOS (Bash 3.2)

✨ No Breaking Changes

• Fully Backward Compatible: All v0.4.1 projects work without modification
• Configuration Compatible: No changes needed to existing .env files

🔄 Update Instructions

To upgrade from v0.4.1 to v0.4.2:

1. Update nself: nself update
2. No other changes needed - completely backward compatible!

v0.4.1 - Platform Compatibility Patch

Released on January 21, 2026

🐛 Bug Fixes

• Bash 3.2 Compatibility: Fixed array declaration syntax (PROGRESS_STEPS=()) for macOS default shell
• Cross-Platform sed: Implemented safe_sed_inline() for macOS/Linux differences
• Cross-Platform stat: Added safe_stat_mtime() and safe_stat_perms() functions
• Portable timeout: Added safe_timeout() with fallback for macOS
• Portable output: Converted echo -e to printf for consistent formatting

✨ No Breaking Changes

• Fully Backward Compatible: All v0.4.0 projects work without modification
• Configuration Compatible: No changes needed to existing .env files

🔄 Update Instructions

To upgrade from v0.4.0 to v0.4.1:

1. Update nself: nself update
2. No other changes needed - completely backward compatible!

v0.4.0 - Production-Ready Stable Release

Released on October 13, 2025

🎯 Production-Ready Milestone

• All Core Features Complete: 36 CLI commands fully functional and tested
• Comprehensive Testing: 12/12 CI tests passing, verified on macOS and Ubuntu
• Production-Ready Stack: All services (PostgreSQL, Hasura, Auth, Storage, Redis, etc.) battle-tested
• 40+ Service Templates: Production-ready templates across multiple languages and frameworks

🌐 Cross-Platform Compatibility

• Bash 3.2+ Support: Full compatibility with macOS default shell (Bash 3.2.57)
• Platform Support: Verified on macOS, Linux, and WSL2 environments
• Universal Compatibility: Works across different shell versions and environments
• No Bash 4+ Dependencies: Replaced modern bash features with portable alternatives

🔧 Critical Bug Fixes

• Unbound Variable Issues: Resolved all shell script unbound variable errors
• Variable Defaults: Added proper defaults and validation throughout codebase
• Uppercase Conversion: Replaced Bash 4+ ^^ with tr command for compatibility
• First-Build Errors: Fixed issues preventing successful first-time builds
• Shell Script Robustness: Enhanced error handling and script reliability

🚀 System Reliability

• Enhanced Error Handling: Better error messages and recovery mechanisms
• Improved Validation: Comprehensive pre-flight checks before operations
• Better Defaults: Smart defaults that work across all environments
• Stability Improvements: More robust service startup and management

📚 Documentation Updates

• Updated all documentation for v0.4.0 release
• Enhanced troubleshooting guides with v0.4.0 fixes
• Improved cross-platform setup instructions
• Updated CLI command reference

✨ No Breaking Changes

• Fully Backward Compatible: All v0.3.x projects work without modification
• Configuration Compatible: No changes needed to existing .env files
• Command Compatible: All existing commands work identically

🔄 Update Instructions

To upgrade from v0.3.x to v0.4.0:

1. Update nself: nself update
2. No other changes needed - completely backward compatible!

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

Released on August 15, 2025

🔐 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

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.