Setting up your local development environment
Prerequisites
Before we continue, make sure that the following components are installed on your development machine.
- Visual Studio Code (https://code.visualstudio.com/download)
- .NET 8 SDK (https://dotnet.microsoft.com/en-us/download/dotnet/8.0)
- NodeJS v16.* or higher (https://nodejs.org/en/)
- Python 3.10 or higher (https://www.python.org/downloads/)
- Visual Studio 2022, select at least the "Desktop development with C++" workload (https://visualstudio.microsoft.com/downloads/)
- Angular CLI: install using
npm install -g @angular/cli - Optional, when using SQL server as a data storage: SQL Server 2019 Developer (https://www.microsoft.com/en-us/sql-server/sql-server-downloads)
- Optional, when using MySQL as a data storage: MySQL 8 or higher (https://www.mysql.com/)
- Optional, when using MariaDB as a data storage: MariaDB 10 or higher (https://mariadb.com/)
- Optional, when using Cosmos DB as a data storage: Azure Cosmos DB Emulator (https://aka.ms/cosmosdb-emulator)
- Optional: Windows Terminal (https://www.microsoft.com/en-us/p/windows-terminal/9n0dx20hk701)
Extracting your app
Extract the ZIP-file containing your app's source code to a specific folder on your development machine. In this example we will use: C:\apps\myapp
Running ServiceLayer, the app's ASP.NET Core OData API
Open a new PowerShell terminal in: C:\apps\myapp\ServiceLayer
Execute .\run.cmd. Your ServiceLayer should start within seconds.
A new browser window will open, showing your app's API OData endpoint.
Running NgLayer, the app's Angular UI
Open a new PowerShell terminal in: C:\apps\myapp\NgLayer
Execute .\install.cmd, this will install all node_modules required to run your app's user interface. It can take a while.
After the installation of all node_modules is completed, execute: .\run.cmd
This will compile and launch your app's user interface.
Login with your credentials.
You did it. You started your first wyStack app! 🚀
Let's continue.