Skip to content

gdgoc-7th-winter/front-end

Repository files navigation

front-end

이 프로젝트는 확장성과 유지보수성을 고려하여 구성된 React 기반 프론트엔드 애플리케이션입니다.
빠른 개발 환경, 일관된 스타일링, 안정적인 상태 관리, 그리고 타입 안정성을 중심으로 설계되었습니다.


📦 기술 스택 요약

  • Vite (React) (7.3.1)
  • TypeScript (5.9.3)
  • Tailwind CSS (4.2.1)
  • TanStack Query (5.90.21)
  • React Router DOM (7.13.0)
  • Zustand (5.0.11)
  • React Hook Form (7.71.2)
  • Axios (1.13.5)

🚀 프레임워크

Vite (React) (7.3.1)

Vite는 빠른 개발 서버 구동과 뛰어난 HMR(Hot Module Replacement) 성능을 제공합니다.
불필요한 번들링 과정을 줄여 개발 경험(DX)을 향상시키고, 경량화된 빌드 결과물을 생성할 수 있어 생산성과 성능을 동시에 확보할 수 있습니다.

React는 컴포넌트 기반 구조를 통해 UI를 재사용 가능하게 설계할 수 있으며, 복잡한 인터페이스를 구조적으로 관리할 수 있는 기반을 제공합니다.


🟦 프로그래밍 언어

TypeScript (5.9.3)

TypeScript를 도입하여 정적 타입 기반 개발 환경을 구축했습니다.
API 응답 구조와 컴포넌트 props를 명확하게 정의함으로써 런타임 에러를 줄이고 유지보수성을 높입니다.
규모가 확장되더라도 안전하게 리팩토링할 수 있는 기반을 제공합니다.


🎨 스타일링(CSS 프레임워크)

Tailwind CSS (4.2.1)

Tailwind는 유틸리티 퍼스트 CSS 프레임워크로, 빠른 UI 개발과 일관된 디자인 시스템 유지를 가능하게 합니다.
별도의 CSS 파일 관리 부담을 줄이고, 클래스 기반 스타일링으로 컴포넌트 단위 개발에 최적화되어 있습니다.


🔄 상태 관리(서버)

TanStack Query (5.90.21)

TanStack Query는 서버 상태를 효율적으로 관리하기 위한 라이브러리입니다.
데이터 캐싱, 자동 리패칭, 로딩/에러 상태 관리 등을 통해 비동기 데이터 처리를 단순화합니다.
네트워크 요청을 체계적으로 관리함으로써 사용자 경험을 향상시킵니다.


🧭 라우팅

React Router DOM (7.13.0)

React Router DOM을 사용하여 SPA 환경에서 URL 기반 라우팅을 구현합니다.
페이지 전환, 동적 라우팅, 인증 기반 접근 제어 등을 유연하게 구성할 수 있습니다.


🗂️ 상태 관리(클라이언트)

Zustand (5.0.11)

Zustand는 가볍고 직관적인 전역 상태 관리 라이브러리입니다.
복잡한 보일러플레이트 없이 간단한 전역 상태를 관리할 수 있으며, UI 상태와 서버 상태를 명확히 분리하는 데 적합합니다.


📝 폼 관리

React Hook Form (7.71.2)

React Hook Form은 성능 중심의 폼 상태 관리 라이브러리입니다.
불필요한 리렌더링을 최소화하며, 유효성 검사 로직을 효율적으로 구성할 수 있습니다.
복잡한 입력 폼을 구조적으로 관리하기 위해 도입했습니다.


🌐 API 연결

Axios (1.13.5)

Axios는 HTTP 요청을 보다 구조적으로 관리하기 위해 사용합니다.
인터셉터를 통해 토큰 처리, 공통 에러 핸들링, 요청/응답 로깅 등을 중앙 집중적으로 관리할 수 있습니다.


🏗️ 개발 원칙(추후 변동)

  • 서버 상태와 클라이언트 상태를 명확히 분리

  • UI와 데이터 로직 분리

  • 타입 기반 안전한 개발 환경 유지

  • 확장 가능한 상태 관리 구조

  • 안전한 타입 기반 개발

  • 유지보수성을 고려한 아키텍처 설계

About

프론트엔드 레포

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors