-
Notifications
You must be signed in to change notification settings - Fork 1.2k
v5.0.0
Bryan Soltis edited this page Dec 11, 2025
·
10 revisions
Version 5.0.0 is a major release featuring .NET 10.0 framework upgrade, modern dashboard redesign, SQLite database support, Azure Tenant Name Validation, enhanced UI/UX, improved configuration management, and API versioning support.
- Latest .NET version - Upgraded from .NET 8.0 to .NET 10.0
- Performance improvements with enhanced runtime efficiency
- Security updates including latest patches and improvements
- Modern features providing access to newest .NET capabilities
- Long-term support for better maintainability
- Breaking change: Requires .NET 10.0 runtime for deployment
- See Migration Guide for upgrade instructions
- Two-column hero layout with logo on left, custom content on right
- Configuration Overview stats grid showing counts for all enabled components
- Featured "Names Generated" stat card with gradient styling
- Responsive design optimized for mobile and desktop
- Custom Home Content support - Markdown editor for personalized welcome messages
- Fixed component name matching issues (ResourceOrg, ResourceProjAppSvc, ResourceFunction)
- Improved visual hierarchy and card-based design
- Optional upgrade - SQLite available for enhanced performance (not default)
- Enhanced performance with faster data access and queries
- Better scalability for larger configurations
- Improved reliability with transactional support and data integrity
- Built-in migration tool from file-based storage to SQLite
- One-click migration with automatic backup creation
- Rollback support if migration issues occur
- Admin UI for easy storage provider management
- Default remains JSON file-based storage for maximum compatibility
⚠️ IMPORTANT: SQLite not recommended for Azure Container Apps with File Share mounts (use FileSystem storage instead)
- Validate generated names against your Azure tenant before deployment
- Prevent naming conflicts by checking if resource names already exist
- Support for both Managed Identity (recommended) and Service Principal authentication
- Flexible conflict resolution strategies:
- NotifyOnly - Warn about conflicts but allow generation (default)
- AutoIncrement - Automatically append incremented suffix (e.g., -001, -002)
- Fail - Block generation if name exists
- SuffixRandom - Add random suffix to resolve conflicts
- Performance caching to minimize Azure API calls
- Scoped validation - configure specific subscription(s) to check
- Multi-subscription support for enterprise deployments
- Integrated into Site Settings for easy configuration
-
⚠️ IMPORTANT: This feature requires SQLite storage. You must migrate to SQLite before enabling Azure Tenant Name Validation.
- Consistent card-based design across all Admin tabs
- Redesigned Admin page with modern tabbed interface
- Boxed styling with hover effects for all settings
- Improved visual hierarchy and spacing
- Optimized grouped settings (e.g., Site Navigation toggles)
- Enhanced toast notifications with modern styling
- Better mobile support with responsive breakpoints
- Modern, clean interface throughout the application
- Intuitive drag-and-drop sorting for all configuration lists
- Replaces up/down arrow controls with drag handles
- Visual feedback during drag operations
- Immediate persistence to storage (JSON or SQLite)
- Supports: Components, Environments, Functions, Locations, Orgs, Projects/Apps/Services, Units/Depts, Custom Components
- Support for API versioning (v1 and v2)
- Separate Swagger documentation for each version
- v1 endpoints remain stable; v2 enables future enhancements
- Bulk operations support for processing multiple naming requests
- Improved error handling with better error messages and validation
- Extended filtering options for querying configurations
- No breaking changes to existing v1 APIs
- New stats grid showing counts for all enabled resource components
- Featured Names Generated card with gradient background
- Custom Home Content editor now properly initializes with saved content
- Better organization of quick start guide and feature descriptions
- Fixed ID reassignment issues during list reorders
- Corrected sort-order behavior when Enabled flag changes
- Added dedicated UpdateSortOrder APIs for reliable persistence
- Transactional SQLite saves with proper cache invalidation
- Fixed component name matching for ResourceOrg, ResourceProjAppSvc, and ResourceFunction
- Backup and Restore functionality for both JSON and SQLite
- Individual component import/export for granular configuration control
- Pre-migration backup creation before SQLite conversion
- Enhanced error handling and validation during imports
- Improved Blazor component rendering with render-key strategy
- Better JavaScript handler initialization after DOM updates
- More reliable UI updates across all configuration sections
- MarkdownEditor initialization with proper async loading
- SQLite database option for faster queries and better scalability
- Improved caching for Azure validation results
- Optimized component loading on dashboard
- Faster configuration page rendering
- Review the v5.0.0 Migration Guide for detailed upgrade instructions
- Backup your configuration before upgrading (use Admin → Configuration → Export)
- Site restart required after deployment and configuration restore
- Test in a development environment before upgrading production
-
FileSystem/JSON (default): Ensure write permissions to
repository/andsettings/folders - SQLite (recommended for production): Use built-in migration tool in Admin → Configuration
- Migration is optional - file-based storage remains fully supported
- Backups recommended before migrating to SQLite
- Enable in Admin → Site Settings → "Azure Tenant Name Validation"
- Configure authentication (Managed Identity recommended for Azure deployments)
- Set conflict resolution strategy based on your naming convention
- Test connection before saving configuration
- Requires appropriate Azure RBAC permissions (Reader role minimum)
- Custom Home Content can be configured in Admin → Customization tab
- Supports Markdown formatting for rich content
- Custom logo can be uploaded to personalize branding
- Changes take effect after application restart
- No breaking changes to v1 endpoints
- v2 endpoints are opt-in and experimental
- Swagger documentation available at
/swagger/index.html
- Fixed configuration list ordering persistence issues
- Resolved Enabled flag affecting sort order
- Improved client/server data synchronization
- Fixed spacing inconsistencies in grouped UI elements
- Fixed component name mismatches preventing stats from displaying (ResourceOrg, ResourceProjAppSvc, ResourceFunction)
- Fixed Custom Home Content not loading in MarkdownEditor on Admin page
- Fixed isCustomComponent detection logic to properly identify custom vs. built-in components
- Resolved focus outline issues on modal dialogs
- Improved error handling in configuration import/export
- Fixed cache invalidation after configuration updates
For detailed feature guides, see:
- v5.0.0 Migration Guide - Complete upgrade instructions
- Azure Validation Admin Guide - Setup and configuration
- Azure Validation API Guide - API integration
- Azure Validation Security Guide - Security best practices
- Backup and Restore Guide - Configuration backup procedures
- Modern design system with consistent spacing, colors, and typography
- Card-based layouts for better content organization
- Improved accessibility with proper focus management
- Enhanced mobile experience with responsive breakpoints
- Better visual feedback with hover states and transitions
- Cleaner navigation with modern tab interface
- Professional styling throughout the application
Thanks to all contributors and testers who helped validate features, identify bugs, and improve the user experience.
For issues or questions, please open a GitHub issue in the repository.