Springfield Devs Website

Prerequisites

• .NET SDK 10.x
• Node.js 18.x

Local Installation Instructions

There are a couple of ways to run this project depending on if you have a .NET IDE installed or just the CLI tools

Environment Specific Steps

Local media uses SeaweedFS. With Docker Compose installed, run from the repo root:

docker compose up -d

The local bucket is created automatically at http://localhost:8333. The development launch profiles supply local-only credentials. Media persists across restarts; docker compose down --volumes deletes it.

• Create an Umbraco.sqlite.db file in the ./SgfDevs/umbraco/Data directory
  • Mac OS/Linux mkdir -p ./SgfDevs/umbraco/Data && touch ./SgfDevs/umbraco/Data/Umbraco.sqlite.db
  • Windows New-Item -ItemType Directory -Force -Path .\SgfDevs\umbraco\Data; New-Item -ItemType File -Force -Path .\SgfDevs\umbraco\Data\Umbraco.sqlite.db

CLI Tools

• Navigate to the SgfDevs project folder cd SgfDevs
• Use the dotnet user-secrets command to set your connection string
  • dotnet user-secrets set "ConnectionStrings:umbracoDbDSN" "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True;Default Timeout=60"
• dotnet run --launch-profile Umbraco.Web.UI
• Open the URL that's printed in the console in your browser

.NET IDE e.g. Rider or Visual Studio (Windows)

• Update your .NET User Secrets with a connection string
  • Most IDEs have a shortcut to navigate to this file
  • Reference appsettings.json for an example of the ConnectionStrings object
    • Set umbracoDbDSN to something like Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True;Default Timeout=60
  • You can also fall back to the CLI tools instructions
• Your IDE will likely have some kind of run option, run this and it should launch your browser

Umbraco In-browser Steps

• Once the site has been launched you should see an Umbraco screen to create a new account
• Fill this out and wait a few seconds for Umbraco to install
• Once you're redirected to the Admin, click on the Settings tab
• Navigation to "uSync" under "Synchronization" in the left panel
• Under the "Everything" card click the green "Import" button
• Once this is finished navigate to the site's root url and you should see a functioning site

Building CSS

• Navigate to the SgfDevs project folder cd SgfDevs
• npm install
• npm run build or to watch for changes npm run css