# awen-prompt

AwenPrompt - local-first рабочее пространство для более точных промптов в архитектурной визуализации. Я собрал его вокруг деталей, которые обычные промпт-инструменты часто пропускают: геометрия референса, поведение мембраны, реальные цвета материалов, намерение камеры и явные правила того, что нельзя менять.

Он не генерирует изображения. Он помогает подготовить промпты для внешних image tools, особенно для тентовых конструкций, мембран, ETFE, сетки, фасадов, интерьеров, site scenes и световых исследований. [Открыть production app](https://awen-prompt.vercel.app/) или прочитать подробную статью: [AwenPrompt: structured prompts for architectural visualization](https://glvn.me/blog/#awenprompt-structured-prompts-architectural-visualization).

## почему я сделал этот инструмент

Я часто видел, как AI render workflows ломают архитектуру одинаковым образом: исчезают мачты, переезжают тросы, уплывают цвета ткани, выпрямляются кривые кровли, а референс превращается в mood board. AwenPrompt нужен, чтобы важные ограничения были записаны явно до того, как промпт уходит из проектного процесса.

## коротко

- Prompt builder для тентовых конструкций, фасадов, интерьеров, площадок и световых исследований.
- Auto-Fill из брифа, референса или готового промпта.
- Каталог материалов для ткани, конструкции и архитектурных отделок.
- Native mode без API key.
- Optional AI-assisted mode через hosted demo или bring-your-own-key routes.
- Mask и lighting editors для точечных правок изображения.
- Browser-local workspace для сессий, ревью, импорта и экспорта.

## как собирается промпт

Сначала выбирается тип архитектурного исследования. AwenPrompt показывает поля, которые важны именно для этого workflow: контекст площадки, материалы, поведение ткани или оболочки, камера, свет, формат результата, правила сохранения и negative prompts.

Поля можно заполнить вручную, дать Auto-Fill прочитать бриф или референс, либо переиспользовать старый промпт. После этого приложение собирает результат как текст или JSON, чтобы его можно было перенести в тот image tool, которым вы пользуетесь.

## резервный режим

Главный fallback - Native mode. После загрузки приложение может собирать промпты из формы без аккаунта, hosted demo quota или API key.

Hosted AI route также пробует короткую server-owned fallback chain при временных сбоях провайдера. Если и она не помогает, пользователь может продолжить работу в Native mode или подключить личный ключ провайдера для текущей вкладки браузера.

## стек

- Next.js, React и TypeScript.
- Tailwind CSS, shadcn/ui, Radix primitives и lucide-react icons.
- OpenRouter hosted demo routes, плюс OpenRouter и OpenAI BYOK support.
- IndexedDB и localStorage для browser-local workspace data.
- Vitest и ESLint для проверок domain logic, routes, providers, storage и UI behavior.