v10.0.0

🚀🎉 Perigon 10.0 Launch

We are thrilled to announce the official release of Perigon.CLI 10.0! This update introduces a host of exciting new features and improvements designed to enhance developer productivity and the overall development experience.

In short, Perigon is a development assistant tool built around technology stacks such as Aspire, ASP.NET Core, and EF Core, helping you rapidly build maintainable projects. It primarily offers:

• Project Scaffolding: Quickly create project structures that follow best practices using solution templates (Perigon.Templates).
• Code Generator: Provides a WebUI interface to generate CRUD (Create, Read, Update, Delete) code based on entities, as well as client-side request services—significantly reducing repetitive tasks. It also supports custom templates to meet diverse project requirements.
• MCP Support: Offers MCP (Model-Code-Prompt) integration to work seamlessly with AI features in existing IDEs.
• Command-Line Tool: Enables creating solutions, launching the WebUI, generating client request services, and more.

✨ New Feature

In 2025, .NET 10 was released. At the beginning of the year, I began planning a comprehensive refactoring and optimization effort to deliver an entirely new version—fully built on .NET 10 and no longer compatible with previous versions. After months of development and testing, we have now released Perigon.CLI and Perigon.Templates. Key features of this release include:

• UI Technology Stack: Migrated the user interface from Angular to Blazor Server, using the Fluent UI component library—aligning both technically and visually closer to the .NET ecosystem.

• Simplified Project Structure: Removed unnecessary complexity and adopted a more generic approach by eliminating the following:

  • The Repository Pattern
  • The default design using separate QueryDbContext and CommandDbContext, which required an additional DataAccess abstraction layer
  • Auto-generated business interface classes
  • The [Module] attribute—modules are now distinguished purely by directory structure
  • Other redundant abstractions and over-engineered designs

• Restructured project layout with more practical and widely applicable features added:

  • Aspire Integration: Addresses local development infrastructure and multi-service orchestration
  • Multi-Service Support: Seamlessly blends monolithic and microservice architectures within a single solution
  • Multi-Tenancy Support: Switch between single-tenant and multi-tenant modes via configuration
  • Multi-Database Support: Leverages a factory pattern to support various database providers
  • Multi-Language Support: Built-in internationalization capabilities for global applications
  • MCP Support: Enables direct code generation from within your IDE
  • Source Generator Support: Includes multi-language templates and automatic injection of Manager classes

More importantly, this new version establishes several core design principles:

• Generic and Open: Avoids dependency on specific design patterns or architectures; prioritizes widely adopted and mature .NET technologies
• Simple and Easy to Use: Introduces no new architectural theories or patterns—minimizing learning curves and cognitive load
• Developer-Centric: Enhancing developer productivity and experience remains the primary goal

Full Changelog: v8.2.8...v10.0.0

📚 Docs

Now, you can visit our official document website!

v9.0.0-rc1

🎉 V9.0.0-rc1 Release

What Changed

该版本重构了代码目录结构，为未来的功能开发提供支撑。将之前以命令行为主的工具，变成以Web UI为主的工具。
该版本主要一些变化:

• 使用Sqlite替换了LiteDb，好处是更方便后续的开发，坏处是增加了打包体积
• 支持slnx格式的项目
• 重构了代码生成方式，引入了razor引擎模型
• 添加了生成任务模块功能，可自定义生成的内容(通过编写razor模板)
• 前端框架升级到了Angular 19，全面使用standalone，并应用最新的Material主题
• 完善了Csharp客户端请求的代码生成
• 项目模板默认集成了.NET Aspire
• 项目模板进一步简化了抽象，并修改了接口默认返回
• 依赖更新

Upgrade Instructions

9.0从模板到生成内容，与8.0都不兼容，所以，基于8.0的项目，并不能直接使用9.0的工具。

建议使用9.0创建新的项目，新项目目标框架仍然为.NET8。

后续会完善文档，以介绍版本的不同，以便提供手动升级的可能。

Full Changelog: v8.2.8...v9.0.0-rc1

v8.2.8

更新内容

主要修改了前端请求服务生成的目录结构。旧项目如果使用新版本生成 ，前端引用服务和模型的路径需要全部改动(谨慎)。

新目录结构具有更好的组织方式和兼容性，后续基本不会再变动了。

Full Changelog: v8.2.5...v8.2.8