QUICKSTART — COLLABTUNES JSON-TO-AIO RENDER ENGINE
Version: 5-13-26
============================================================

WHAT THIS IS
------------
A one-command machine that converts a Collaborhythm JSON file
into a complete, styled AIO HTML page.


FILES IN THIS PACKAGE
---------------------
  JSON_SCHEMA_EXAMPLE_5_13_26.json       <- Your JSON goes here (or make your own)
  JSON_TO_AIO_RENDER_ENGINE_5_13_26.py   <- The engine
  AIO_RENDER_TEMPLATE_5_13_26.html       <- The HTML template
  GENERATED_EXAMPLE_AIO_PAGE_5_13_26.html <- Proof it works


REQUIREMENTS
------------
  Python 3.7+
  No external libraries needed. All stdlib.


HOW TO RUN
----------

1. BASIC (auto-named output):
   python JSON_TO_AIO_RENDER_ENGINE_5_13_26.py my_release.json

   Output: my_release_AIO_YYYYMMDD_HHMMSS.html

2. SPECIFY OUTPUT NAME:
   python JSON_TO_AIO_RENDER_ENGINE_5_13_26.py my_release.json my_page.html

3. USE A CUSTOM TEMPLATE:
   python JSON_TO_AIO_RENDER_ENGINE_5_13_26.py my_release.json my_page.html --template MY_TEMPLATE.html


WHERE JSON GOES
---------------
  In the same folder as the engine, or provide a full/relative path.
  Follow the schema in JSON_SCHEMA_EXAMPLE_5_13_26.json.

  Required top-level keys:
    title, collection_type, artist, rating, gx_score,
    summaries, tracks, tags, nav_links, metadata

  Optional:
    subtitle, warnings, cover_art_url, release_date


WHERE HTML OUTPUTS
------------------
  Same folder as the engine by default.
  Specify any path as the second argument to redirect output.


HOW TO CUSTOMIZE THE TEMPLATE
------------------------------
  Open AIO_RENDER_TEMPLATE_5_13_26.html in any text editor.

  Template tokens (double-curly-brace format):
    {{TITLE}}              <- Release title
    {{COLLECTION_TYPE}}    <- EP / LP / SINGLE / etc.
    {{ARTIST}}             <- Artist name
    {{RATING_SCORE}}       <- Numeric rating
    {{RATING_LABEL}}       <- Text label (ESSENTIAL, RECOMMENDED, etc.)
    {{GX_VALUE}}           <- GX score number
    {{SHORT_SUMMARY}}      <- One-line summary
    {{LONG_SUMMARY}}       <- Full critical write-up
    {{NAV_LINKS}}          <- Auto-generated nav links
    {{TRACKS}}             <- Auto-generated track rows
    {{GX_BREAKDOWN}}       <- Auto-generated score grid
    {{WARNINGS_SECTION}}   <- Auto-generated warnings (omitted if empty)
    {{TAGS_CLOUD}}         <- Auto-generated tags
    {{METADATA_GRID}}      <- Auto-generated metadata table
    {{CRITICAL_NOTE}}      <- Critical note block (omitted if empty)
    {{CATALOG_ID}}         <- Footer catalog ID

  CSS variables are in :root {} — edit colors/fonts there.


EXAMPLE RUN (out of the box)
-----------------------------
  python JSON_TO_AIO_RENDER_ENGINE_5_13_26.py JSON_SCHEMA_EXAMPLE_5_13_26.json GENERATED_EXAMPLE_AIO_PAGE_5_13_26.html

  Open GENERATED_EXAMPLE_AIO_PAGE_5_13_26.html in any browser.
  That is the engine working.


============================================================
COLLABTUNES_JSON_TO_AIO_RENDER_ENGINE_5_13_26 — Collaborhythm System
Built: 2026-05-13
============================================================
