Version: 1.2

Release Notes

v1.2 — 2026-07-04

Official Shumoul brand identity applied platform-wide (Phase D1).

The portal now matches platform.shumoul.com visually — official logo (light and dark variants), the approved Primary Blue (#0077FF) / Primary Teal (#00B39F) palette on a dark navy background, and Cairo typeface (self-hosted, Arabic-first) site-wide.
Dark mode is now the primary experience for every new visitor; light mode remains fully supported via the manual toggle, using the same identity with inverted neutral surfaces.
Every component restyled to one consistent design language: navbar, sidebar, footer, buttons, cards, admonitions, tables, code blocks, tabs, pagination, table of contents, search box, version dropdown, and badges — no generic Docusaurus green theme remains anywhere on the site.
Homepage redesigned as a full enterprise product page: Hero, Framework cards, Certified Frameworks, Quick Start, Architecture & APIs, Latest Releases, and Developer Resources.
New Brand System section — the single source of truth for colors, typography, spacing, component styling, logo usage, and theme rules for every future addition to this portal.
No framework documentation content was rewritten — this release is design-system only.

Background Jobs Framework published as the platform's second certified module.

Background Jobs Framework published: 20 chapters covering overview, architecture, all 5 packages (Contracts, Abstractions, Core, Adapters, entry point), the runtime pipeline and execution flows, every runtime service, the two-tier adapter model, tenant context, distributed locking, the scheduler, execution context, the complete 36-type public API, host integration, the full job migration guide (6 completed migrations), architecture decisions (ADR-003 through ADR-006), testing, performance, troubleshooting, and FAQ.
Homepage adds a Certified Frameworks section, surfacing each framework's Golden Reference / Level 3 / LTS certification status at a glance — updated with a new card whenever a framework reaches this bar.
The Frameworks navigation now shows Background Jobs Framework as a live, published module rather than a hidden placeholder.
This documentation was transformed from the platform's existing, frozen architecture record (docs/ARCHITECTURE/BACKGROUND_JOBS_*.md and ADRs in the Shumoul.Saas.Api repository) — no architecture was redesigned or reinterpreted in the process.

Initial launch of the Shumoul Developer Portal.

Portal built on Docusaurus 3, with full-text search, native Mermaid diagram rendering, syntax-highlighted and copyable code blocks, and documentation versioning enabled.
Notification Framework published as the first complete module: 20 chapters covering architecture, framework packages, runtime flow, every notification channel, templates, a full 120-action HTTP API reference, SignalR, device tokens, the retry/dead-letter engine, notification history, permissions, configuration, deployment, testing, troubleshooting, and FAQ.
Navigation placeholders prepared (not yet published) for: Background Jobs Framework, E-Invoicing Framework, Payments Framework, Identity Framework, Multi-Tenancy Framework, and general ERP APIs.
Portal-wide sections established: Getting Started, Architecture, APIs, Guides, Tutorials, Best Practices, FAQ, and About Shumoul.