Midsummer Developer Docs

Quickstart 👉

Stand up a local instance and run the dev server.

Quickstart

Systems 👉

What each application (register, vendors, staff, schedule, …) does.

Systems

Concepts & Theory 👉

The architecture: multi-tenancy, the custom form system, request resolution, payments.

Concepts & Theory

Reference 👉

Tech stack, management commands, the backend API, and the data model.

Reference

Operational Guides 👉

Runbooks for adding tenants, custom domains, and updating metrics.

Operational guides

Agent Guide 🤖

Context and conventions for AI coding agents bootstrapping work on Midsummer.

Agent guide

Midsummer V2 is a multi-tenant monolith — a Django 5.x backend serving REST + WebSocket APIs, with several Angular single-page apps as frontends, all over one PostgreSQL database with per-tenant schema isolation (django-tenants).

Conventions are places for people to come together. Big tech companies take advantage of small to medium sized events. Midsummer provides the baseline of what events should be able to do without those companies. — project mission

These docs are the developer-facing companion to the product. They are written for the engineers and agents who build and operate Midsummer, not the attendees who use it. For the high-level project summary, see the project mission & features.

What you’ll find here

  • Quickstart — from a clean machine to a running instance at {{ dev_url }}, plus the day-to-day workflow and troubleshooting.

  • Systems — a focused explainer for each Django app: accounts, event, register, vendors, staff, schedule, shop, tenant, and kioskos.

  • Concepts & Theory — the why behind the code: schema-based multi-tenancy, the JSON form-builder system, how a request is resolved, the permission model, Stripe payments, and audit logging.

  • Reference — the tech stack, every management command, the REST/WebSocket API surface, and the data model.

  • Operational Guides — step-by-step runbooks (onboarding a new tenant, setting up a custom domain, refreshing year-over-year metrics).

  • Agent Guide — a distilled orientation designed for AI coding agents to consume before working in the codebase.

A 30-second mental model

HTTP request
   │
   ▼
TenantMainMiddleware   ── reads host ──► Tenant + schema switch + URLconf
OAuthDomainMiddleware  ── routes /o/* on the global OAuth domain only
EventSetupMiddleware   ── resolves request.current_event (subdomain / custom domain)
   │
   ▼
/app/<module>/...      ── REST (DRF ViewSets + @api_view) ──► tenant schema
/api/v2026-01/...      ── versioned public API
/ws/...                ── Django Channels (jury voting, staff ping)
   │
   ▼
Angular SPA            ── ui/ (Angular 21) for events · tenantui/ (Angular 19) for tenant admin

Ready? Start with the Quickstart.