39 lines
3.6 KiB
Markdown
39 lines
3.6 KiB
Markdown
# AGENTS.md
|
||
|
||
Пустой стартовый шаблон Fluw (shadcn + Payload-ready) — чистая основа для нового веб-приложения. `src/app/page.tsx` сейчас содержит сплэш-заставку Fluw, которую заменяют, когда начинают строить реальный продукт.
|
||
|
||
## Project Specifics
|
||
|
||
- `src/app/page.tsx` — стартовая заставка (Fluw splash). Это placeholder: при старте реального продукта заменяй его композицией страниц, а не оставляй заставку.
|
||
- Раскладывай новый UI по FSD: страницы-композиции → `src/widgets/*`, пользовательские сценарии → `src/features/*`, бизнес-данные → `src/entities/*`, примитивы — `src/shared/*`. Не складывай всё в один файл.
|
||
- Базовые UI-примитивы shadcn — в `src/shared/ui/*` (vendored, не переписывай). Доступен `framer-motion` (анимации заставки).
|
||
- Проверка после правок: `pnpm lint` и `pnpm build`.
|
||
|
||
## Design System
|
||
|
||
Источник токенов — `src/app/globals.css` (`@theme` + `:root`/`.dark`, дефолтная нейтральная shadcn-тема, `--radius` 0.625rem). Шрифт — Roboto Flex (`--font-roboto-flex`).
|
||
|
||
**Это чистая основа без заданного характера** — главный риск дженерик-вывода. Поэтому при построении продукта:
|
||
|
||
- **Сначала выбери направление и зашей его в токены** `globals.css` (`--primary`, `--secondary`, `--accent`, `--radius`, типографику), затем работай через семантические классы (`bg-primary`, `text-foreground`) — не хардкодь hex/oklch в компонентах.
|
||
- **Заставка — исключение:** текущий `page.tsx` намеренно использует фирменный Fluw-стиль (тёмный фон + зелёный `#4ADE80`) напрямую, потому что это служебный placeholder, а не часть продукта. Реальные страницы строй на токенах.
|
||
- Делай дизайн осознанным и узнаваемым под задачу пользователя, а не «ещё один shadcn-лендинг».
|
||
|
||
## File Map
|
||
|
||
| Route | Файл |
|
||
|---|---|
|
||
| `/` | `src/app/page.tsx` — Fluw splash (placeholder, заменяется при старте продукта) |
|
||
|
||
Структура для нового кода: `src/widgets/` (композиции страниц), `src/features/` (сценарии), `src/entities/` (данные/контент), `src/shared/ui` (примитивы), `src/shared/lib` + `src/shared/hooks` (утилиты/хуки).
|
||
|
||
<!-- BEGIN:nextjs-agent-rules -->
|
||
|
||
# This is NOT the Next.js you know
|
||
|
||
This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices.
|
||
|
||
This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.
|
||
|
||
<!-- END:nextjs-agent-rules -->
|