초기 화면을 만든 뒤 테마, 배포, 권한, 운영 기준으로 확장하는 순서를 안내합니다.
첫 화면이 완성되면 레이아웃, 문구, 라우팅 이름을 한 번 고정하는 시간이 필요합니다. 이 시점에 기준을 잡지 않으면 이후 페이지가 늘어날수록 메뉴와 화면 구성이 빠르게 어긋납니다.
- route 이름 규칙을 문서화합니다.
- 공통 top nav와 footer 사용 여부를 정합니다.
- 빈 상태와 에러 상태를 최소 한 번씩 확인합니다.
테마는 색을 바꾸는 작업이 아니라 화면 간 우선순위와 상태 표현을 일관되게 만드는 작업입니다. 버튼, 링크, card, table 같은 반복 컴포넌트의 기본 톤을 먼저 맞춘 뒤 페이지별 강조를 얹습니다.
- 색상 token은 의미 기준으로 사용합니다.
- radius와 spacing은 페이지마다 임의로 늘리지 않습니다.
- dark mode가 있다면 대비를 함께 검토합니다.
배포 전에는 빌드 산출물, 환경 변수, health check, 정적 자산 경로를 확인합니다. 로컬에서 보이던 화면이 배포 후 깨지는 문제는 대부분 base path, 캐시, 누락된 설정에서 발생합니다.
- 운영 프로파일의 필수 설정을 목록화합니다.
- health endpoint와 대표 HTML route를 확인합니다.
- 배포 파일에 불필요한 로컬 산출물이 들어가지 않게 합니다.
운영 가능한 앱은 장애가 없다는 뜻이 아니라 장애를 빨리 알아차리고 좁힐 수 있다는 뜻입니다. 로그, 추적 ID, 사용자 행동 경로, 배포 버전을 연결해 두면 UI 문제도 서비스 문제처럼 진단할 수 있습니다.
- 사용자 오류와 서버 오류를 구분해 기록합니다.
- 릴리스 버전을 화면 또는 로그에서 확인 가능하게 합니다.
- 자주 보는 운영 링크는 admin 또는 docs에 연결합니다.
Java 중심 UI 시스템으로 제품 수준의 웹 앱을 더 빠르게 구축합니다. 공통 컴포넌트와 레이아웃을 기반으로 사이트를 일관되게 확장할 수 있습니다.