.. _about:

About T3Toon
============

What is T3Toon?
---------------

**T3Toon** (Token-Optimized Object Notation) is a compact, human-readable, and token-efficient data format designed specifically for AI and LLM integrations in TYPO3 CMS.

It transforms large JSON or PHP arrays into a format that:

* Reduces token usage by up to 70% compared to JSON
* Maintains human readability (YAML-like structure)
* Preserves complete data structure and key order
* Supports bidirectional conversion (JSON ⇄ TOON)

Use Cases
---------

T3Toon is perfect for:

* **AI Prompt Engineering**: Compress structured data for LLMs (ChatGPT, Gemini, Claude, Mistral)
* **Token Optimization**: Reduce token usage and API costs
* **Data Preprocessing**: Streamline complex structured inputs
* **Logging & Debugging**: Store compact, readable structured logs
* **Database Storage**: Reduce JSON storage size while preserving structure
* **Developer Tools**: Perfect for previews and compact dashboards

Why T3Toon?
-----------

When working with AI APIs, every token counts. Traditional JSON format includes:

* Redundant quotes around keys and string values
* Verbose syntax (braces, brackets, commas)
* Repeated structural markers

T3Toon eliminates this overhead while maintaining:

* Complete data fidelity
* Human readability
* Easy parsing and conversion
* Support for complex nested structures

Example Comparison
------------------

**JSON Format** (7.7 KB, ~1,930 tokens):

.. code-block:: json

   {
     "user": "ABC",
     "message": "Hello, how are you?",
     "tasks": [
       {"id": 1, "done": false},
       {"id": 2, "done": true}
     ]
   }

**TOON Format** (2.5 KB, ~640 tokens):

.. code-block:: text

   user: ABC
   message: Hello\, how are you?
   tasks:
     items[2]{done,id}:
       false,1
       true,2

**Result**: ~67% size reduction and ~66.8% fewer tokens while retaining complete data accuracy.