Local Development Setup

Prerequisites

• Windows 10+, Linux, or macOS
• PostgreSQL for the local database
• Visual Studio 2022 (recommended for best development experience)
  • alternatively VS Code with the .NET 8.0 SDK

1. Install Postgresql

• Windows & macOS: https://www.enterprisedb.com/downloads/postgres-postgresql-downloads
• Linux: https://www.postgresql.org/download/
• Make sure you don't have an old version already installed
• Use the default user postgres with a password postgres, and the default port of 5432 (if you wish to override any of these settings, override the connection string using user secrets)
• Postgresql master password: Run pgAdmin4 and change it to postgres

2a. Using Visual Studio

1. Install Visual Studio Community 2022 from https://visualstudio.microsoft.com/
2. Run Visual Studio installer and select the following:
   • ASP.NET and web development
   • .NET desktop development
3. Clone repository
   • To properly contribute, use your repository fork url created via Basic Git Contribution Tutorial, which should look like https://github.com/{YourUserName}/tasvideos.git,
   • or for testing use https://github.com/TASVideos/tasvideos.git
4. Open TASVideos.sln
5. Select the following project to be built:
   • Dev (Generate Sample Data)
   • Next time Dev (Sample Data No Recreate) can be used for quicker start up times.

2b. Using VS Code

If you don't use Visual Studio, you can use VS Code and manually install the .NET SDK.

1. Install the .NET SDK: https://dotnet.microsoft.com/en-us/download/dotnet/8.0
2. Install VS Code from https://code.visualstudio.com/Download
3. Install C# extension: CTRL(CMD)+SHIFT+X > C#
4. Clone Repository: CTRL+SHIFT+G > Clone Repository
   • To properly contribute, use your repository fork url created via Basic Git Contribution Tutorial, which should look like https://github.com/{YourUserName}/tasvideos.git,
   • or for testing use https://github.com/TASVideos/tasvideos.git
5. Build TASVideos: CTRL(CMD)+SHIFT+D
   • Select TASVideos (Generate Sample Data), click on green arrow to run
   • Next time TASVideos (Sample Data No Recreate) can be used for quicker start up times.

---

Working with Sample Data

Using the launch profile "Generate Sample Data" will download a reduced and cleaned version of the live production database into your local database. This can take some minutes. After the first successful run of this, you can switch to the profile Sample Data No Recreate to increase startup time.

In the cleaned db, all users' passwords are changed to Password1234!@#$.