mirror of
https://github.com/langgenius/dify.git
synced 2026-05-10 22:28:55 +08:00
9331024d91
Co-authored-by: CodingOnStar <hanxujiang@dify.com> Co-authored-by: autofix-ci[bot] <114827586+autofix-ci[bot]@users.noreply.github.com> Co-authored-by: yyh <yuanyouhuilyz@gmail.com>
25 lines
1.4 KiB
Markdown
25 lines
1.4 KiB
Markdown
## Frontend Workflow
|
|
|
|
- Refer to the `./docs/test.md` and `./docs/lint.md` for detailed frontend workflow instructions.
|
|
|
|
## Overlay Components (Mandatory)
|
|
|
|
- `../packages/dify-ui/README.md` is the permanent contract for overlay primitives, portals, root `isolation: isolate`, and the `z-1002` / `z-1003` layering.
|
|
- `./docs/overlay-migration.md` is the source of truth for the ongoing migration (deprecated import paths and coexistence rules).
|
|
- In new or modified code, use only overlay primitives from `@langgenius/dify-ui/*`.
|
|
- Do not introduce deprecated overlay imports from `@/app/components/base/*`; when touching legacy callers, prefer migrating them.
|
|
|
|
## Query & Mutation (Mandatory)
|
|
|
|
- `frontend-query-mutation` is the source of truth for Dify frontend contracts, query and mutation call-site patterns, conditional queries, invalidation, and mutation error handling.
|
|
|
|
## Design Token Mapping
|
|
|
|
- When translating Figma designs to code, read `../packages/dify-ui/AGENTS.md` for the Figma `--radius/*` token to Tailwind `rounded-*` class mapping. The two scales are offset by one step.
|
|
|
|
## Automated Test Generation
|
|
|
|
- Use `./docs/test.md` as the canonical instruction set for generating frontend automated tests.
|
|
- When proposing or saving tests, re-read that document and follow every requirement.
|
|
- All frontend tests MUST also comply with the `frontend-testing` skill. Treat the skill as a mandatory constraint, not optional guidance.
|