This repository contains an ASP.NET Core WebAPI application that implements JWT Authentication, a .NET MAUI application for administrative frontend that consumes the protected WebAPI.
repository
|__src
| |__Foody -> web api project
| |__client -> maui project
| |__.gitignore
|__.gitignore
|__ReadME.md
The Project can be run locally or on codespaces.
Some requirement and workloads to install:
Open a command prompt(windows) or terminal(mac) and enter clone the repository:
git clone https://github.com/coderBane/food-web-app.git
Open the repository in codespaces by clicking on the code dropdown menu and selecting codespaces
We need to setup a few things first before running the projects.
- Database : PostgreSQL database
- Distributed Cache : Redis distributed
- Install dotnet global tools
dotnet ef
dotnet tool install --global dotnet-efCreate a redis container instance
docker run --name redis-cache -p 6379:6379 -d redis
Create a container instance
docker run --name postgresql -e POSTGRES_PASSWORD=<yourpassword> -p 5432:5432 -d postgres
Run psql
docker exec -it postgresql psql -U postgres
First we'll need to create an new role. The role would have login and database creation priviledges.
CREATE ROLE devuser WITH LOGIN CREATEDB PASSWORD '<yourpassword>';
Switch to the new user
\c postgres devuser
Create the database
CREATE DATABASE foody;
NOTE: You can run the command \l to view all existing databases
Before we can run the project we need to configure a few things for the web api. Open the Foody.WebApi.csproj file and delete the UserSecretsId property.
Open a new terminal or command prompt and change directory to the Foody.WebApi folder.
Run the command:
dotnet user-secrets init
Generate a random string using this website random.
Create a new file 's.json' and populate it with the following
{
"JwtConfig": {
"Secret": "<generatedstring>",
"ExpiryTimeFrame": "00:01:00"
},
"WatchDog": {
"Username": "<yourusername>",
"Password": "<yourpassword>"
},
"Redis": "localhost",
"Postgres": "Server=localhost:5432;Database=foody;User Id=devuser;Password=<devuserpassword>;Integrated Security=true;Pooling=true;",
"UserPW": "<yourpassword>"
}
Set the user secrets
cat ./s.json | dotnet user-secrets set
NOTE: You can delete the s.json file
We need to create the tables in the database.
dotnet ef --startup-project ../Foody.WebApi database update
We can now run the projects
launch without swagger
dotnet run
launch with swagger UI
dotnet watch