src/apis
index.ts
- 중복코드 제거, 인터셉터 관리, 일관된 설정 관리 면에서 유지 보수/재사용성/일관성/모듈화 면에서 apiRequest를 사용해 api 요청을 하는 편이 중복 코드를 줄임 → 인터셉터 적용하여 apiRequest를 작성
- axios 요청 시 apiRequest를 사용하여 서버 요청을 하시면 됩니다.(
src/apis/project.ts, src/apis/user.ts,src/apis/portfolio.ts 코드 참고)
src/components
/common
NoImage.tsx
- 이미지 파일이 깨져 이미지를 불러오지 못하거나 이미지를 추가하지 않았을 경우 표시되는 대체 이미지입니다. (포트폴리오/프로젝트 이미지 모두 사용 가능)
- 사용하실 때 필수 전달 props는
height입니다.
- 전달 가능 선택 props는
width, border-radius 속성인 borderRadius, border-top-right/left-radius 속성인 borderTopRadius입니다.
PortfolioItem.tsx
- 포트폴리오 아이템입니다. 현재 메인 페이지, 검색 결과 페이지, 마이 포트폴리오 페이지에 적용되고 있습니다.
- 클릭 시 해당 포트폴리오 id 상세 페이지로 이동하도록 컴포넌트 내에 구현해서 따로 useNavigate 로직을 추가하실 필요 없습니다.
- 사용 시 포트폴리오 리스트 배열을 map() 메소드를 돌려서 map() 메소드 첫 번째 인자인 아이템을 넣어주시면 됩니다.
UserProfileImage.tsx
- 사용자 프로필 이미지입니다. 사용자가 프로필 이미지를 등록하지 않았을 경우 기본 프로필 이미지로 대체되고, 프로필 이미지를 등록했다면 해당 프로필 이미지가 반영됩니다.
- 사용하실 때 필수 전달 props는 img 태그에 들어갈 src 속성인
imgSrc, width와 height 값이 되는 size입니다.
- 전달 가능 선택 props는
isLoading입니다. isLoading는 새로고침 시 기본 프로필 이미지가 깜빡였다가 설정 이미지가 보이는 이슈를 방지하기 위해 Nav 컴포넌트에서 설정한 props입니다.
/createPortfolio
TechStackTag.tsx
- 기술 스택 태그를 추가하고 삭제할 수 있는 컴포넌트입니다.
- 사용하실 때 필수 전달 props는 string으로 이루어진
techStack state 배열, techStack의 상태를 변경시키는 setTechStack, 전체 박스 width값인 StWidth입니다.
src/constants
portfolioFilteringData.ts
- 직군 카테고리, 직무 태그 필터를 상수화한 파일입니다.
- 직군 카테고리는
CATEGORY_KEYWORD입니다.
- 직무 태그 필터는
FILTER_KEYWORD입니다.
- 둘 다 객체로 설정했기 때문에 필요한 직군, 직무 필터를 사용하실 때 import 해오신 후
. 찍으시면 자동완성으로 key값들이 나올텐데 필요한 key값을 지정하면 됩니다. ex) CATEGORY_KEYWORD.DESIGN, FILTER_KEYWORD.DEVELOP.FRONTEND
src/Hook
useDecodeJWT.ts
- 라이브러리를 사용하지 않고 액세스 토큰을 디코딩한 커스텀 훅입니다.
- 멘토님이 토큰에 추가 암호화를 한 것이 아니라면 라이브러리를 사용할 필요가 없다고 하셨으니 jwt-decode를 사용한 부분을 교체하시면 될 것 같습니다.
- 사용 시 decodedJWT를 return값으로 가져오게 됩니다.
useOnChangeInput.ts
- input창 사용 시 각 상태에 e.target.value를 상태에 적용하고 유효성 검사를 체크해주는 커스텀 훅입니다.
- 사용하실 때 필수 전달 props는 input의 value 상태를 바꾸는
setRecoilState입니다.(recoil 관련이 아닌 useState의 setState여도 상관없음)
- 전달 가능 선택 props는 input value 상태값에 해당하는
inputValue, 유효성 검사 함수 validator입니다.
- 사용 시 input 태그에 반영할
onChangeInput 함수, 유효성 검사 결과값 isInvalid, input 창 아래 뜨게 될 errorMessage를 return값으로 가져올 수 있습니다.
src/style
- /common/
commonStyles.ts
- 공통적으로 자주 쓰게되는 스타일링 코드를 넣어주시면 됩니다.
- 현재는 전체 페이지에 적용 가능한 각 페이지의 좌우 패딩값이 고정된
PageContainer, 메인 페이지와 검색 결과 페이지, 마이 포트폴리오에 적용된 PortfolioListContainer 스타일링 코드가 존재합니다.
GlobalStyle.tsx
- 태그 지정 후 스타일링을 지정하면 해당 태그를 가진 모든 페이지, 컴포넌트에 스타일이 적용되게 됩니다.
- 전역적인 스타일링이 필요할 경우 추가해주시면 됩니다.
theme.ts
- 자주 사용하는 메인 색상을 추가해놨습니다. 꺼내서 쓰시면 됩니다