trentuna/opencd
8
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
opencd/RELEASE_NOTES.md

4.6 KiB
Raw Permalink Blame History

OpenCD v1.0.0 — Release Notes

"I love it when a plan comes together." — Col. John "Hannibal" Smith

Release date: 2026-05-25 Commit: Latest on main (GPG-signed: D1ADA6EC42B96E5BDAE95B5B48DF9E0094796329) Framework: OpenCD — Physical CD jewel case HTML/CSS framework Built on: Open Props v2

Team Credits

Role Profile Key Area
Commander Hannibal Smith 48DF9E0094796329 Final synthesis, release, signed final commit
Recon Face 696A18EFB764ADE RECON.md — Open Props audit, CD specs, ASW/trentuna study
Gate Amy Allen C103A95E28714F6C MISSION_BRIEF.md — quality criteria, findings, gate review
Prototype Murdock ABE295FFEB4571F8 opencd.css + 3 HTML templates (jewel-case, leaflet, back-tray)
Production B.A. Baracus 1D05905DE3C03A27 Hardened opencd.css — zero magic numbers, Nous auth, ASW semantics
Validation Amy Allen C103A95E28714F6C VALIDATION.md — 12 PASS, 1 CONCERNS, 0 FAIL
Architect Hannibal Smith 48DF9E0094796329 DESIGN.md — framework architecture planning

All commits are GPG-signed with individual team member keys.

Deliverables

Core Framework

  • opencd.css (711 lines) — CD jewel case CSS framework
    • ISO 15727 physical CD dimensions at 2× scale
    • 60+ --cd-* custom properties (zero Open Props token leakage)
    • ASW-style semantic surface layers in oklch colorspace
    • 7-component architecture: jewel case, spine, leaflet, disc art, advisory badge, back tray, grid overlay
    • Open/close state via BEM modifier + data-jewel-state attribute
    • Container query responsive design
    • Print styles with physical mm units
    • Grain texture utility classes
    • Zero magic numbers — every value is a --cd-* custom property

Templates

  • templates/jewel-case.html — CD jewel case wrapper with open/close + scale demo controls
  • templates/leaflet.html — 4-page booklet with page-turn navigation
  • templates/back-tray.html — Dual spines, tracklist, credits, grid toggle

Documentation

  • README.md — Project overview, quick start, philosophy
  • DESIGN.md — Architecture plan: 9 CSS modules, Open Props token mapping, responsibility matrix
  • RECON.md — Reconnaissance: Open Props audit, CD specification analysis, ASW/trentuna study
  • MISSION_BRIEF.md — Quality criteria, 4 findings, and gate review with CONCERNS verdict for initial prototype
  • VALIDATION.md — 12 PASS / 1 CONCERNS / 0 FAIL validation of production build (follow-up fixed)
  • RELEASE_NOTES.md — This file

Infrastructure

  • .env.example — Nous auth configuration schema
  • .gitignore — Standard ignores (.env, editor files, build artifacts)

Quality Summary

The production build passed validation with 12/12 PASS criteria, 0 FAIL. A single CONCERNS — three inline values violating the zero-magic-numbers principle — was addressed in this release (final synthesis pass). The three values (font-weight: 600, opacity: 0.8, z-index: 1) now use proper --cd-* custom properties: --cd-font-weight-semibold, --cd-text-opacity-muted, --cd-z-stack-base.

Architecture Highlights

  • Physical-dimension-driven design — every layout value traces back to real CD packaging measurements (ISO 15727)
  • Custom property cascade — :root defines dimension, color, typography, spacing, and motion tokens; components reference --cd-* only
  • ASW-style colors — Surface layers use custom oklch values instead of Open Props defaults, giving the framework a distinct visual identity
  • Open Props integration — Safely uses Open Props for internal values (font sizes, spacing ratios, shadows, easings) while exposing a clean --cd-* public API
  • Responsive architecture — Container queries at 350px/550px breakpoints; print styles auto-switch to physical mm units
  • No JavaScript required — Template interactions (open/close, page turns) use native HTML/CSS with minimal inline JS for demo controls

Getting Started

<!-- Include in your project -->
<link rel="stylesheet" href="https://unpkg.com/open-props">
<link rel="stylesheet" href="opencd.css">

<!-- Use a template -->
<h1>Your CD Project</h1>
<article class="cd-jewel" data-jewel-state="open">
  <!-- ... -->
</article>

See templates/jewel-case.html for a complete working example.

License: MIT Built with: Open Props v2+ Nous deployment: Portal URL and API key schema in .env.example