# PROMETEU Test Cartridges

This directory contains example cartridges and test suites to validate the behavior of the PROMETEU runtime and development tools.

## Available Cartridges

### 🟩 [color-square-ts](color-square-ts)
A simple cartridge that demonstrates:
- System initialization.
- Rendering a colored square in the framebuffer.
- Basic execution loop.

## Cartridge Structure

A PROMETEU cartridge (in its unpacked form) generally consists of:
- `manifest.json`: Application metadata (ID, title, version, mode).
- `program.pbc`: Compiled bytecode for the PROMETEU VM.
- `assets/`: Resources such as tiles, sprites, and audio samples.

## How to use

You can run any of these cartridges using the main CLI:

```bash
prometeu run test-cartridges/<cartridge_name>
```