첫 프로젝트 시작

starter 선택부터 첫 route 확인까지 가장 짧은 경로로 LMGX 앱을 시작합니다.

Starter 선택

첫 프로젝트는 기능을 많이 켜기보다 라우팅, 레이아웃, 테마가 이미 연결된 starter에서 시작하는 편이 안정적입니다. 팀이 바로 확인해야 하는 것은 화면이 뜨는지, 공통 네비게이션이 유지되는지, 문서에 적힌 기본 명령이 로컬에서도 재현되는지입니다.

- Java와 빌드 도구 버전을 먼저 맞춥니다.

- 초기 route는 작고 명확한 이름으로 시작합니다.

- 샘플 화면은 삭제하지 말고 기준 화면으로 남겨 둡니다.

애플리케이션을 실행한 뒤에는 홈, 문서, 테마 같은 대표 route를 먼저 확인합니다. 서버가 뜨는 것만으로는 충분하지 않으며 정적 자산, 상단 메뉴, footer, 반응형 전환까지 같이 보는 것이 좋습니다.

- 개발 서버 로그에서 포트와 프로파일을 확인합니다.

- 브라우저 새로고침과 직접 URL 접근을 모두 테스트합니다.

- 초기 에러는 설정 문제인지 코드 문제인지 나눠서 기록합니다.

첫 화면은 데이터 연동보다 화면 구조를 증명하는 데 집중합니다. 제목, 설명, 주요 action, 빈 상태를 넣고 공통 레이아웃 안에서 자연스럽게 보이는지 확인하면 이후 기능을 붙일 때 흔들림이 줄어듭니다.

- 큰 section을 먼저 만들고 내부 card는 나중에 채웁니다.

- 링크는 실제 route로 연결합니다.

- 모바일에서 제목과 버튼이 겹치지 않는지 봅니다.

Quick Start의 완료 기준은 코드가 컴파일되는 것보다 사용자가 다음 문서로 넘어갈 수 있는 상태입니다. 실행 명령, 대표 route, 기본 UI 상태를 한 번에 점검하면 이후 튜토리얼이나 보안 설정을 붙이기 쉬워집니다.

- 주요 route가 200으로 응답해야 합니다.

- 좌측 docs 메뉴에서 현재 페이지가 강조되어야 합니다.

- 우측 On this page 커서가 스크롤 위치를 따라 이동해야 합니다.