Migration v1

Migration Guide: v0.x → v1.0

This guide helps you migrate from SwaggerUI.Themes v0.x to v1.0.

Contents

• Breaking Changes
• Migration Steps
• Automated Migration
• Migration Checklist
• Upgrading Further?
• Need Help?

⚠️ Breaking Changes

Namespace Update

What Changed:

The namespace was updated for consistency with the broader library structure.

Old Namespace (v0.x)	New Namespace (v1.0+)
AspNetCore.SwaggerUI.Themes	AspNetCore.Swagger.Themes

Why:

• Better naming consistency
• Clearer package structure
• Aligns with ASP.NET Core conventions

Migration Steps

Update Your Using Statements

// ❌ Before (v0.x)
using AspNetCore.SwaggerUI.Themes;

// ✅ After (v1.0+)
using AspNetCore.Swagger.Themes;

Verify Everything Still Works

using AspNetCore.Swagger.Themes;

// Rest of your code remains the same
app.UseSwaggerUI(Style.Dark);

No Other Changes

Everything else remains the same:

• ✅ Same class names (Style, ModernStyle)
• ✅ Same theme properties (.Dark, .Light, etc.)
• ✅ Same configuration methods
• ✅ Same features and functionality

Automated Migration

Use your IDE's find-and-replace:

Find	Replace
using AspNetCore.SwaggerUI.Themes;	using AspNetCore.Swagger.Themes;

Scope: Entire solution

Migration Checklist

• Update all using AspNetCore.SwaggerUI.Themes; statements
• Build your project
• Verify no compiler errors
• Test your application

Upgrading Further?

If you're migrating from v0.x directly to v2.0 or v3.0, you'll also need to apply additional changes:

• v1.x → v2.0 Migration Guide (if going to v2.0)
• v2.x → v3.0 Migration Guide (if going to v3.0)

Need Help?

• Check the Getting Started guide
• Open an issue on GitHub

---

Migration complete! Your application is now running v1.0. ✅