React with ASP.NET Core ⚡

A starter template for building modern web applications with ASP.NET Core (backend) and React (frontend).

✨ This boilerplate provides a pre-configured setup for full-stack development, bundling, and deployment

📦 Installation & usage

🔸 Prerequisites

• .NET 8 SDK
• Node.js (LTS recommended)
• A package manager: npm - usually installed with node installation

🔸 Installation - this command will create a project in target folder with provided name

  npx create-rwc@latest

🔸 Options: and for quick actions

  npx create-rwc@latest -n <ProjectName> -o <vs-or-code> [-i] [-g] [-f] [-h]

  Options:
    -n or --name      Project name
    -o or --open      Open project with selected IDE
    -i or --install   Run npm install after scaffolding
    -g or --git       Initialize a git repo
    -f or --force     Overwrite non-empty target directory
    -h or --help      Show help

🔸 Usage: from root

  dotnet run

This will:

• Start the ASP.NET Core backend on https://localhost:PORT
• Start the React dev server (proxied through .NET Core)

🗂 Project Structure

├── projectName.Client
└── nested
    ├── public
    ├── src
    └── nested
        ├── assets
        ├── App.css
        ├── index.css
        ├── App.jsx
        ├── main.jsx
    ├── projectName.esproj
    ├── index.html
    ├── package.json
    └─ vite.config.js
├── projectName.Server
└── nested
    ├── Controllers
    ├── Properties
    ├── projectName.csproj
    ├── projectName.csproj.user
    ├── projectName.http
    ├── appsettings.json
    ├── appsettings.development.json
    ├── Program.cs
    └─ WeatherForecast.cs
└── projectName.sln

• @mmnagueb - Mostafa Nagueb