tfbSoft
All posts
BaseForge27 September 20262 min read

The BaseForge documentation site is live

BaseForge is now English-first: a brand-new documentation site, step-by-step guides and a bilingual Designer make generating .NET microservices from a spec easier than ever.

BaseForge is the open-source base library and code generator we build for .NET 10 microservices. Until now its documentation was Turkish-only and lived inside the GitHub repository. This week we changed that: BaseForge now has its own documentation site — English first, with full Turkish support.

👉 dropdeart.github.io/BaseForge

What does BaseForge do?

Every new backend service needs the same foundations: a layered architecture, CQRS, repositories, audit fields, authentication, service-to-service communication, logging, health checks and Docker files. BaseForge makes those decisions once and ships them in two parts:

  • The library: a single AddBaseForge() call gives you CQRS (MediatR), EF Core + Dapper, audit and soft delete, JWT, RabbitMQ and centralized logging.

  • The generator: describe your entities in YAML or in the browser-based Designer, and BaseForge generates plain, readable C# that builds and runs with Docker.

What's on the site?

  • Getting Started: install the CLI and have your first service running in five minutes.

  • Designer tour: design entities, relations, access rules and Identity visually.

  • Service Spec reference: every YAML option, field type and validation rule on one page.

  • Identity & authorization: social logins, roles, record ownership and user profile fields.

  • Deploying to production: Docker Compose, automatic HTTPS with Caddy and a go-live checklist.

  • Architecture decisions: a record of what we decided and why.

Why English?

BaseForge is published as a public NuGet package, and the .NET community is global. The first thing a developer sees after finding the package should be in a language they can read. That's why the README, the docs and the Designer are now in English. Turkish isn't going anywhere: the whole site is available in Turkish, and the Designer switches languages with one click.

Try it now

dotnet tool install -g BaseForge.CodeGen --prerelease
mkdir my-platform && cd my-platform
baseforge new orders

The Designer opens in your browser. Add your entities, press Generate + Build, then Run — your service starts in Docker with its API reference ready.

Feedback and contributions are always welcome on the GitHub repository.