# 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](./directory-structure.md) | JSP pages, includes, and static assets | Project decision documented |
| [Component Guidelines](./component-guidelines.md) | JSP fragments, forms, tables, and reusable UI | Project decision documented |
| [Hook Guidelines](./hook-guidelines.md) | No React/Vue hook conventions unless introduced later | Project decision documented |
| [State Management](./state-management.md) | Server-rendered request/session/form state | Project decision documented |
| [Quality Guidelines](./quality-guidelines.md) | Image-to-JSP restoration and UI checks | Project decision documented |
| [Type Safety](./type-safety.md) | 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.md`
  records the initial pre-scaffold repo scan.
- `.trellis/tasks/archive/2026-04/00-bootstrap-guidelines/research/project-requirements.md`
  records the developer-provided JSP presentation approach and image-to-JSP
  workflow.

---

**Language**: All documentation should be written in **English**.
