.NET MonoRepo starter project

A solid starting point for your new Nx based .NET MonoRepo.

What's included?

• pnpm workspace
• Nx
• nx-dotnet plugin
• semantic-release
• GitHub Actions for linting PR title with Conventional Commit rules, CI & Release
• Arc42 documentation template with Astro Starlight
• Renovate for automated dependency updates

Getting Started

1. Run the following command to create a new project-name

   npx degit https://github.com/froko/dotnet-monorepo <project-name>

2. Run pnpm install

3. Change into the project directory and create a first commit with

   git init
   git add .
   git commit -m "chore: initial commit"

4. Make it yours by changing some information in the following files

   • README.json
   • package.json (name, description, author, repository url)
   • docs/astro.config.json (title, social url)
   • docs/src/content/docs/index.mdx (title)

5. Commit your changes

   git add .
   git commit -m "chore: update project information"

6. Create a new .NET projects in either the apps or libs directory

7. Depending on the project type (production, test), copy the appropriate project-[type].json file to the project directory and rename it to project.json

Available commands on the root level

• pnpm install - Install all dependencies
• pnpm format - Format all projects
• pnpm lint - Lint all projects
• pnpm build - Build all projects
• pnpm test - Run all tests
• pnpm affected - Lint, Build & Test all affected projects
• pnpm all - Lint, Build & Test all projects

Workspace structure

By default, the pnpm workspace comes with preconfigured directories for apps and libs. You can add more directories or change the default ones by modifying the pnpm-workspace.yaml file. Nx will automatically adhere to these changes.

References

• pnpm
• pnpm Workspaces
• Nx
• nx-dotnet
• Conventional Commits
• semantic-release
• Arc42
• Astro
• Astro Starlight
• Renovate