SpeakingInBits Learn

A learning platform: instructors create courses/lessons, students enroll and track progress, admins manage users, with Open Badges for gamification. See docs/features.md for the full feature backlog.

This repo is currently in its scaffolding phase — the solution, auth, data access, storage abstraction, and test harness are set up, but no course/lesson/badge feature code exists yet.

Getting started

Prerequisites: .NET SDK 10.0.300+ (pinned via global.json), SQL Server LocalDB, Node.js (for the local Blob storage emulator).

git clone <this repo>
cd SpeakingInBits-Learn
dotnet tool restore
dotnet ef database update --project src/SpeakingInBits.Learn --startup-project src/SpeakingInBits.Learn
dotnet build
dotnet test

To run the app locally, also start the Blob storage emulator first — see docs/azurite-local-dev.md:

cd tools/azurite && npm install && npm start

Then, from the repo root: dotnet run --project src/SpeakingInBits.Learn.

See AGENTS.md for the full repo map and links into docs/ (architecture, coding conventions, testing strategy, EF Core migrations).

Connecting this repo to GitHub

The GitHub CLI (gh) isn't installed in this environment, so the remote wasn't created automatically. To push this repo to GitHub:

1. Create a new empty repository on github.com under your account — do not initialize it with a README, .gitignore, or license, since this repo already has its own and that would cause a merge conflict.
2. From the repo root:

   git remote add origin https://github.com/<your-username>/SpeakingInBits-Learn.git
   git branch -M main
   git push -u origin main