- VSCode
- GitBash
- C#
- .NET6 SDK
- MSTest
- Windows Powershell
- Razor
- CSS
- HTML
- MySQL Server
- MySQL Workbench
-
This web-based application allows a user to create a unique profile, add and rank recipes, and categorize them according to recipe tags.
-
This app utilizes simple authentication for basic security and user-entered data integrity.
-
Within the app, the user can:
- Add and delete recipes
- Add and delete recipe tags
- Assign recipes to specific tags
- Add details to an individual recipe
- View a list of all recipes entered by the user
- View a list of all tags entered by the user
- NOTE: In order to run this application, you will need to ensure the following software packages are installed locally:
- .NET6
- MySQL and MySQL workbench
- A code editor of your choice (VSCode, Sublime Text, etc.)
- Install .NET6 if you have not done so. Visit this link to download the recommended versions of both software packages.
- Follow the installer prompts to install the software. Use the default settings.
- In a terminal, install
dotnet-script
by entering the following command:$ dotnet tool install -g dotnet-script
. You will also need to configure your environment to access this tool. See this link. - Install MySQL. Follow the instructions at this link.
- Clone this repository.
- Open the terminal and navigate to this project's production directory, named "RecipeBox".
- Within the production directory "RecipeBox", create a new file called appsettings.json.
- Open your code editor and navigate to appsetings.json.
- Within appsettings.json, add the following code, replacing the
uid
andpwd
values with your own username and password for MySQL.
{
"ConnectionStrings": {
"DefaultConnection": "Server=localhost;Port=3306;database=recipe_box;uid=[uid];pwd=[pwd];"
}
}
- Open MySQL Workbench and locate the Navigator pane (on the left-hand side of the program window.)
- Select "Data Import/Restore", which will open the Data Import page.
- Select the option labeled "Import from Self Contained File". Navigate to the top directory of the files you downloaded from this repository ("RecipeBox").
- Within "RecipeBox", select the file named recipe_box.sql.
- Under "Default Schema to be Imported To", click the "New..." button, enter the name of the database (recipe_box.sql), and click "OK".
- Navigate to the "Start Import" button located in the lower right corner of the Data Import Pane. (Note: If you cannot find the button, you may need to expand MySQL's window size to reveal it.)
- On the Navigator panel, select the "Schemas" tab. Click the "refresh" icon (two arrows arranged in a circle in the top right corner of the pane), and the database should appear.
- Open a terminal and navigate to this project's production directory ("RecipeBox") if you have not already done so.
- Type
dotnet watch run
in the command line to start the project in development mode with a watcher.
- If the build fails, revisit steps 1 - 3 above to ensure that .NET6 has been properly installed.
- Open the browser to https:localhost:5001.
- If you cannot access localhost:5001, it is likely because you have not configured a .NET developer security certificate for HTTPS. (Please see this page for instructions on how to fix this issue.
- SEE LICENSE HERE