Nx Multilanguage Monorepo

This is a multilanguage monorepo powered by Nx, designed to support scalable development across multiple languages and frameworks. It enables clear separation of concerns, efficient CI, and consistent tooling for all project types.

---

📦 Tech Stack

Currently supported languages and frameworks:

• React (TypeScript) – via @nx/react
• .NET Core (C#) – via @nx-dotnet/core
• Node.js – via @nx/node, @nx/express
• Python (planned) – via @nxlv/python, nx-python
• Kotlin/Java (planned) – via @nx/gradle, jnxplus

---

📁 Folder Structure

To get an overview of the folders structure visit docs/folder-structure.md.

---

🧩 Project Naming

See docs/naming-and-tags.md for details on naming and tagging conventions.

---

🧭 Nx Plugin Reference

A detailed comparison of available Nx plugins across languages is available in docs/nx-multilang-plugins.md, including capabilities and maintenance status.

---

🚀 Getting Started

Prerequisites

• Node.js (18+)
• Nx CLI – optional but recommended
• .NET SDK (only for C# projects)

React setup

To serve the react application, use the following commands:

# Install dependencies
npm install

# Run an app
npx nx serve react-transactions-app

.NET Setup

This section is only relevant for developers working on .NET Core projects. other language contributors can safely skip this.

For step-by-step instructions to add and work with .NET Core projects, see docs/dotnet-nx-setup.md.

Serving Full Stack

To run a full stack app (React + .NET Core), use the following commands:

# Start the React app
npx nx run react-transactions-app:serve

Requires a .NET setup

# Run setup command
npm run dotnet:setup
# Start the .NET Core app
npx nx run dotnet-transactions-api:serve --port=5087

View projects graph

npx nx dep-graph

---

🧪 CI/CD

• Conventional commits are crucial for the CI/CD process. Documentation available in docs/conventional-commits.md.
• Workflow overview documentation is available in docs/release-flow.md.
• Technical information about CI/CD can be found in docs/ci-cd.md.

Workflow	Trigger	Purpose
ci.yml	PR to main	Lint, test, build, e2e affected
deploy.yml	Push to main	Build & deploy React app
nuget-publish.yml	Tag v*.*.*	Pack & publish .NET libraries
npm-publish.yml	Tag v*.*.*	Publish JS packages to npm
version.yml	Push to main	Bump versions, tag last-release

---

📚 Documentation

• docs/monorepo-benefits.md
• docs/folder-structure.md
• docs/naming-and-tags.md
• docs/monorepo-generation.md
• docs/react-lib-generation.md
• docs/nx-multilang-plugins.md
• docs/dotnet-nx-setup.md
• docs/conventional-commits.md
• docs/release-flow.md
• docs/ci-cd.md
• docs/troubleshooting.md

---

made with ❤ by push-based.io