콘텐츠로 이동

기술 스택

화면은 React SPA예요. 아래 표는 cowork web/package.json 기준이고, 버전은 그 파일에 적힌 값이에요. 라이브러리는 둘로 나눠요. 핵심은 Webcraft 지침이 전제로 삼는 것이고, 교체 가능은 앱 기능에 따라 넣거나 빼는 것이에요.

이것을 다른 것으로 바꾸면 그 영역의 지침이 맞지 않아요.

라이브러리 버전 하는 일
React 19.2.8 화면 그리기
TypeScript 6.0.2 타입 검사
Vite 8.1.5 개발 서버와 빌드
TanStack Router ^1.170.32 주소와 화면 연결. src/pages 폴더로 주소를 정하는 파일 라우팅
TanStack Query ^5.102.8 서버 데이터 조회·캐시·변경
Tailwind CSS 4.3.5 스타일. 색·간격은 테마 토큰으로
shadcn/ui CLI ^4.23.0 화면 부품. Base UI(@base-ui/react 1.9.0) 위에서 동작하는 base-nova 스타일

지침이 이 라이브러리에 기대지 않아요. cowork의 기능을 위해 들어 있어요.

라이브러리 버전 하는 일
Tiptap 3.32.0 본문 편집기. 본문을 쓰는 앱만 필요해요
mermaid 12.2.0 본문 안의 도표 표시
KaTeX 0.19.1 본문 안의 수식 표시
lowlight 3.3.0 본문 안의 코드 강조
lottie-web 5.13.0 애니메이션 그림
react-easy-crop 6.2.3 사진 자르기
yet-another-react-lightbox 3.33.0 사진 크게 보기
Pretendard ^1.3.9 글꼴
Iconify Solar ^1.2.13 아이콘 세트. 스크립트(npm run icons:ui 등)로 쓰는 아이콘만 코드로 생성해요

표에 없는 패키지는 web/package.json에서 확인해요.

도구 하는 일
ESLint 10, typescript-eslint, eslint-plugin-react-hooks, eslint-plugin-unused-imports 일반 린트
knip 안 쓰는 파일·내보내기·패키지 찾기
openapi-typescript 서버 계약(server/openapi.json)에서 타입 생성
Playwright 화면 점검 스크립트(web/scripts/)
shadcn CLI 키트 부품 받기

검사를 어떤 순서로 돌리는지는 린트와 코딩 스타일에 있어요.