initial demo

Author: Karnaukhov-kh

.config/dotnet-tools.json

@@ -0,0 +1,5 @@
+{
+  "version": 1,
+  "isRoot": true,
+  "tools": {}
+}

.editorconfig

@@ -0,0 +1,13 @@
+# Editor configuration, see http://editorconfig.org
+root = true
+
+[*]
+charset = utf-8
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+max_line_length = off
+trim_trailing_whitespace = false

.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+
+permissions:
+  actions: read
+  contents: read
+
+jobs:
+  main:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: nrwl/nx-set-shas@v4
+
+      # Cache node_modules
+      - uses: actions/setup-node@v4
+        with:
+          node-version-file: 'package.json'
+          cache: npm
+
+      - uses: actions/setup-dotnet@v3
+        with:
+          dotnet-version: '9.0.x'
+
+      - run: npm ci
+      - run: npx cypress install
+
+      # Prepend any command with "nx-cloud record --" to record its logs to Nx Cloud
+      # - run: npx nx-cloud record -- echo Hello World
+      - run: npx nx affected -t lint test build e2e --verbose

.gitignore

@@ -0,0 +1,46 @@
+# See https://docs.github.com/en/get-started/getting-started-with-git/ignoring-files for more about ignoring files.
+
+# compiled output
+dist
+tmp
+out-tsc
+
+# dependencies
+node_modules
+
+# IDEs and editors
+/.idea
+.project
+.classpath
+.c9/
+*.launch
+.settings/
+*.sublime-workspace
+
+# IDE - VSCode
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+
+# misc
+/.sass-cache
+/connect.lock
+/coverage
+/libpeerconnection.log
+npm-debug.log
+yarn-error.log
+testem.log
+/typings
+
+# System Files
+.DS_Store
+Thumbs.db
+
+.nx/cache
+.nx/workspace-data
+
+vite.config.*.timestamp*
+vitest.config.*.timestamp*
+test-output

.prettierignore

@@ -0,0 +1,5 @@
+# Add files here to ignore them from prettier formatting
+/dist
+/coverage
+/.nx/cache
+/.nx/workspace-data

.prettierrc

@@ -0,0 +1,3 @@
+{
+  "singleQuote": true
+}

.verdaccio/config.yml

@@ -0,0 +1,28 @@
+# path to a directory with all packages
+storage: ../tmp/local-registry/storage
+
+# a list of other known repositories we can talk to
+uplinks:
+  npmjs:
+    url: https://registry.npmjs.org/
+    maxage: 60m
+
+packages:
+  '**':
+    # give all users (including non-authenticated users) full access
+    # because it is a local registry
+    access: $all
+    publish: $all
+    unpublish: $all
+
+    # if package is not available locally, proxy requests to npm registry
+    proxy: npmjs
+
+# log settings
+log:
+  type: stdout
+  format: pretty
+  level: warn
+
+publish:
+  allow_offline: true # set offline to true to allow publish offline

.vscode/extensions.json

@@ -0,0 +1,7 @@
+{
+  "recommendations": [
+    "nrwl.angular-console",
+    "esbenp.prettier-vscode",
+    "dbaeumer.vscode-eslint"
+  ]
+}

Directory.Build.props

@@ -0,0 +1,19 @@
+<!-- 
+  This file is imported early in the build order. 
+  Use it to set default property values that can be overridden in specific projects.
+-->
+<Project>
+  <PropertyGroup>
+    <!-- Output path configuration -->
+    <RepoRoot>$([System.IO.Path]::GetFullPath('$(MSBuildThisFileDirectory)'))</RepoRoot>
+    <ProjectRelativePath>$([MSBuild]::MakeRelative($(RepoRoot), $(MSBuildProjectDirectory)))</ProjectRelativePath>
+    <BaseOutputPath>$(RepoRoot)dist/$(ProjectRelativePath)</BaseOutputPath>
+    <OutputPath>$(BaseOutputPath)</OutputPath>
+    <BaseIntermediateOutputPath>$(RepoRoot)dist/intermediates/$(ProjectRelativePath)/obj</BaseIntermediateOutputPath>
+    <IntermediateOutputPath>$(BaseIntermediateOutputPath)</IntermediateOutputPath>
+    <AppendTargetFrameworkToOutputPath>true</AppendTargetFrameworkToOutputPath>
+  </PropertyGroup>
+  <PropertyGroup>
+    <RestorePackagesWithLockFile>false</RestorePackagesWithLockFile>
+  </PropertyGroup>
+</Project>

Directory.Build.targets

@@ -0,0 +1,13 @@
+<!-- 
+  This file is imported late in the build order. 
+  Use it to override properties and define dependent properties.
+-->
+<Project>
+  <PropertyGroup>
+    <MSBuildProjectDirRelativePath>$([MSBuild]::MakeRelative($(RepoRoot), $(MSBuildProjectDirectory)))</MSBuildProjectDirRelativePath>
+    <NodeModulesRelativePath>$([MSBuild]::MakeRelative($(MSBuildProjectDirectory), $(RepoRoot)))</NodeModulesRelativePath>
+  </PropertyGroup>
+  <Target Name="CheckNxModuleBoundaries" BeforeTargets="Build">
+    <Exec Command="node $(NodeModulesRelativePath)/node_modules/@nx-dotnet/core/src/tasks/check-module-boundaries.js --project-root &quot;$(MSBuildProjectDirRelativePath)&quot;"/>
+  </Target>
+</Project>

README.md

@@ -1 +1,114 @@
-# multilanguage-monorepo
+# Nx Multilanguage Monorepo
+
+This is a multilanguage monorepo powered by [Nx](https://nx.dev), 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`](./docs/folder-structure.md).
+
+---
+
+## 🧩 Project Naming
+
+See [`docs/naming-and-tags.md`](./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`](./docs/nx-multilang-plugins.md), including capabilities and maintenance status.
+
+---
+
+## 🚀 Getting Started
+
+### Prerequisites
+
+- [Node.js (18+)](https://nodejs.org/)
+- [Nx CLI](https://nx.dev/cli) – optional but recommended
+- [.NET SDK](https://dotnet.microsoft.com/) (only for C# projects)
+
+### Serving Full Stack
+
+To run a full stack app (React + .NET Core), use the following commands:
+
+```bash
+# Install dependencies
+npm install
+```
+
+```bash
+# Start the React app
+npx nx run react-transactions-app:serve
+```
+
+> Requires a .NET setup
+
+```bash
+# Run setup command
+npm run dotnet:setup
+# Start the .NET Core app
+npx nx run dotnet-transactions-api:serve --port=5087
+```
+
+### React setup
+
+To serve the react application, use the following commands:
+
+```bash
+# 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`](./docs/dotnet-nx-setup.md).
+
+### View projects graph
+
+```bash
+npx nx dep-graph
+```
+
+---
+
+## 🧪 CI/CD
+
+TODO
+
+---
+
+## 📚 Documentation
+
+- [`docs/monorepo-benefits.md`](./docs/monorepo-benefits.md)
+- [`docs/folder-structure.md`](./docs/folder-structure.md)
+- [`docs/naming-and-tags.md`](./docs/naming-and-tags.md)
+- [`docs/monorepo-generation.md`](./docs/monorepo-generation.md)
+- [`docs/react-lib-generation.md`](./docs/react-lib-generation.md)
+- [`docs/nx-multilang-plugins.md`](./docs/nx-multilang-plugins.md)
+- [`docs/dotnet-nx-setup.md`](./docs/dotnet-nx-setup.md)
+- [`docs/troubleshooting.md`](./docs/troubleshooting.md)
+
+---
+
+made with ❤ by [push-based.io](https://www.push-based.io)