# CreateForge UI Lab

A useful, frontend-only AI image and video workflow playground extracted from the public interaction patterns of CreateForge AI.

**Live demo:** [CreateForge UI Lab](https://mr-zhangbo.github.io/ai-model-prompt-brief-builder/)

This repository is intentionally not a fake generation service. It lets you compare 17 public model profiles, compose a model-aware request, preview local reference files, copy a human-readable creative brief, export structured JSON, and keep a short history in your own browser. It makes no generation or upload request.

## What works

- Three workflows: AI Image, AI Video, and Reference to Video
- Public UI profiles for 9 image models and 8 video models
- Model-specific mode, ratio, resolution, duration, output, and reference controls
- Local image/video/audio reference previews using object URLs
- Prompt helper blocks for camera, lighting, continuity, and negative constraints
- Human-readable brief generation
- Downloadable JSON request previews
- Five-item local history and a persistent light/dark theme
- Responsive desktop, tablet, and mobile layouts
- No dependencies, build step, account, API key, or backend

## Safety boundary

The project includes UI code and public-facing model metadata only. It does **not** include:

- authentication or user accounts;
- payments, credits, or billing logic;
- provider adapters or generation endpoints;
- databases, storage, queues, webhooks, or private media;
- environment variables, API keys, or production identifiers.

Reference files stay in browser memory. Prompts and request previews are never sent over the network. The recent-preview list uses browser `localStorage` and can be cleared from the interface.

## Run locally

No install is required.

```bash
git clone https://github.com/Mr-ZhangBo/ai-model-prompt-brief-builder.git
cd ai-model-prompt-brief-builder
npm run dev
```

Then open `http://localhost:4173`.

You can also use any static web server. Opening `index.html` directly works in many browsers, but a local server is recommended because the model catalog is an ES module.

## Verify the repository

```bash
npm test
```

The check verifies the 17-model catalog, required assets, clean CreateForge AI link, unique model IDs, and the absence of network/API client code in the runtime files.

## Project structure

```text
.
├── assets/
│   └── createforge-mark.svg
├── docs/
│   ├── index.md
│   ├── model-notes.md
│   └── workflow.md
├── js/
│   ├── app.js
│   └── models.js
├── scripts/
│   ├── check.mjs
│   └── serve.mjs
├── index.html
├── styles.css
└── README.md
```

## Hosted product

For actual AI image and video generation, account services, private media, and hosted workflows, use [CreateForge AI](https://createforgeai.com/). This UI Lab is an open frontend companion, not a replacement for the hosted service.

## License

[MIT](LICENSE)