CONTRIBUTING.md

Contributing

This app leverages ASP.NET Core Blazor and Tailwind CSS.

The following tools are required for development:

• dotnet 6 sdk
• node.js
• Tailwind CLI

The working directory is ./src/InglemoorCodingComputing/

Development Secrets

To add development secrets use the dotnet secrets manager

Email:

Optional

SMTP__Username

SMTP__Server

SMTP_Port

SMTP_Password

SMTP__From (usually the same as SMTP__Username)

learn more

for use in development to not actually send emails

Cosmos DB

Cosmos__Throughput recommended="400"

Cosmos__DatabaseName recommended="InglemoorCodingDB"

Cosmos__ConnStr

Cosmos__UserContainer recommended="Users"

Cosmos__AuthContainer recommended="Authentication"

Cosmos__MeetingsContainer recommended="Meetings"

Cosmos__StaticPagesContainer recommended="Pages"

use the Cosmos DB Emulator in development instead of Azure Cosmos DB.

Blob Storage

BlobStorage__ConnStr

use Azureite in development instead of Azure Blob Storage

Authentication

Password Hashing

see Argon2Id

Argon2id__SaltLength

Argon2id__Parallelism

Argon2id__Memory (in KB)

Argon2id__Iterations

Argon2id__HashLength

Google Auth

optional

see setup instructions

Authentication__Google__ClientSecret

Authentication__Google__ClientId

Admin:

optional

AdminKey: A string used to grant users the admin role.

Starting Tailwind

In a separate console window enter the following:

Linux/Mac:

./tailwind.sh

Windows:

tailwind.cmd

This starts the Tailwind hot reload loop.

Running

With the CLI:

dotnet watch run

Using Visual Studio:

Use VS2022, the sln file is inside ./src/