Zzzz
2.3 KiB
2.3 KiB
Frontend Development Guidelines
Frontend conventions for the JSP/CSS presentation layer.
Overview
The developer has established a JSP-based presentation layer served by a Servlet/Tomcat application. Frontend work should use JSP, JSP includes or fragments, CSS, static images, and small page scripts when needed. Do not assume React, Vue, frontend hooks, SPA state libraries, or TypeScript conventions unless the developer explicitly introduces them later.
The frontend workflow is image-first: UI should be designed or generated as images first, then JSP/CSS pages should restore the design faithfully.
Guidelines Index
| Guide | Description | Status |
|---|---|---|
| Directory Structure | JSP pages, includes, and static assets | Project decision documented |
| Component Guidelines | JSP fragments, forms, tables, and reusable UI | Project decision documented |
| Hook Guidelines | No React/Vue hook conventions unless introduced later | Project decision documented |
| State Management | Server-rendered request/session/form state | Project decision documented |
| Quality Guidelines | Image-to-JSP restoration and UI checks | Project decision documented |
| Type Safety | JSP/Servlet validation and JavaBean display contracts | Project decision documented |
Pre-Development Checklist
Before frontend implementation, read:
.trellis/spec/frontend/directory-structure.md.trellis/spec/frontend/component-guidelines.md.trellis/spec/frontend/hook-guidelines.md.trellis/spec/frontend/state-management.md.trellis/spec/frontend/type-safety.md.trellis/spec/frontend/quality-guidelines.md.trellis/tasks/archive/2026-04/00-bootstrap-guidelines/research/project-requirements.md
Evidence
.trellis/tasks/archive/2026-04/00-bootstrap-guidelines/research/repo-scan.mdrecords the initial pre-scaffold repo scan..trellis/tasks/archive/2026-04/00-bootstrap-guidelines/research/project-requirements.mdrecords the developer-provided JSP presentation approach and image-to-JSP workflow.
Language: All documentation should be written in English.