# React Native 코드베이스 정리하기

By Tarik Pinarci (https://tarikpinarci.com). Published 2023-02-09. Canonical: https://tarikpinarci.com/ko/blog/organizing-react-native-codebase

## 확장 가능하고 유지보수하기 쉬운 코드베이스를 만드는 가이드

React Native 앱에서 코드베이스를 잘 정리하는 것은 유지보수성과 확장성에 매우 중요합니다. 파일과 폴더를 어떻게 구성하느냐에 따라 앞으로 코드베이스를 다루기가 얼마나 쉬울지가 크게 달라집니다.

이 글에서는 React Native 앱을 위한 **_기능 기반(feature-based)_** 폴더 구조와 각 폴더의 역할을 살펴봅니다.

### src 폴더

src 폴더는 앱의 모든 소스 코드가 들어가는 루트 디렉터리입니다. 이 폴더 안에는 각각 특정한 역할을 하는 하위 폴더가 여러 개 있습니다.

### Types

types 폴더에는 앱 전역에서 쓰는 타입을 정의합니다. 모듈 타입, 인터페이스 정의, 그리고 앱 전반에서 써야 하는 그 밖의 커스텀 타입이 여기에 들어갑니다.

모든 타입을 한곳에 모아 두면 앱이 커져도 관리하고 유지보수하기가 쉬워집니다. 또한 모든 기능에서 타입을 일관되게 쓰게 되므로 타입 관련 버그의 위험이 줄고, 버그가 생겨도 잡아내기가 쉬워집니다.

### Lib

lib 폴더에는 앱 전역에서 쓰는 앱 고유의 파일을 둡니다. API 호출을 위한 axios 인스턴스, 에러 처리 서비스, 상수, react-query의 query client 설정 같은 것들이 여기에 들어갈 수 있습니다.

이런 파일을 한곳에 모아 두면 유지보수하기 쉽고, 앱 전체에서 일관성을 지킬 수 있습니다.

### Components

components 폴더에는 재사용 가능한 컴포넌트를 모두 둡니다. 이 컴포넌트들은 독립적이어야 하고 특정 기능이나 도메인에 묶여 있으면 안 됩니다. 헤더, 버튼, 리스트 아이템 같은 것이 이런 컴포넌트의 예입니다.

이런 컴포넌트를 기능 전용 컴포넌트와 분리해 두면 앱 전반에서 관리하고 재사용하기가 쉬워지고, 코드 중복도 줄어듭니다.

### Hooks

hooks 폴더에는 앱 전반에서 쓰는 커스텀 훅을 둡니다. 훅은 컴포넌트 사이에서 상태가 있는 로직을 재사용할 수 있게 해 주는 React의 특별한 함수입니다.

**재사용되거나 여러 곳에서 쓰이는** 커스텀 훅을 모두 한곳에 모아 두면 관리하고 유지보수하기가 쉬워집니다. 또한 코드 중복의 위험이 줄고, 앱의 여러 부분에서 훅을 공유하기도 쉬워집니다.

### Localization

localization 폴더에는 앱의 국제화와 관련된 파일을 모두 둡니다. 언어 파일, 문자열 상수, 그리고 앱에서 여러 언어를 지원하는 데 필요한 그 밖의 리소스가 여기에 들어갑니다.

이런 파일을 한곳에 모아 두면 관리하고 유지보수하기가 쉬워지고, 코드 중복의 위험도 줄며, 앱에서 여러 언어를 지원하기도 쉬워집니다.

### Navigation

navigation 폴더에는 앱의 내비게이션과 관련된 코드를 모두 둡니다. 스택, 타입, 라우트, 그리고 내비게이션을 지원하는 데 필요한 그 밖의 컴포넌트나 함수가 여기에 들어갑니다.

내비게이션 코드를 모두 한곳에 모아 두면 관리하고 유지보수하기가 쉬워지고, 코드 중복의 위험이 줄며, 앱의 여러 부분에서 내비게이션 기능을 공유하기도 쉬워집니다.

### Services

services 폴더에는 앱의 기반 인프라와 관련된 코드를 모두 둡니다. 푸시 알림, 에러 모니터링, 그리고 앱의 기반 기능을 제공하는 그 밖의 서비스를 다루는 코드가 여기에 들어갑니다.

### Theme

theme 폴더에는 다크/라이트 테마 같은 앱의 스타일을 둡니다. 스타일과 테마 파일을 한곳에 두면 필요할 때 앱의 디자인과 분위기를 관리하고 바꾸기가 쉬워집니다.

### Utils

유틸리티 함수는 앱의 여러 부분에서 쓸 수 있는 코드를 재사용하게 해 주므로 React Native 앱에서 중요한 부분이 될 수 있습니다. utils 폴더는 앱 전반에서 쓰는 유틸리티 함수를 두기에 좋은 곳입니다. 이런 함수를 한곳에 모아 두면 코드의 다른 부분에서 쉽게 찾아 쓸 수 있습니다. 예를 들면 React Native 레이아웃 관련 유틸리티 함수가 있습니다.

### Features

복잡한 앱을 만들 때는 모든 코드를 한곳에 담아내는 명확하고 간결한 폴더 구조가 꼭 필요합니다. features 폴더는 앱의 여러 기능을 각각의 범주로 나눠 주기 때문에 이 목표를 이루는 데 도움이 됩니다. 덕분에 개발자는 앱의 다른 부분에 영향을 주지 않고 특정 기능을 빠르게 찾아서 수정할 수 있습니다.

게다가 앱이 커지고 기능이 늘어나도 폴더 구조가 정돈된 상태로 유지되므로, 새로 합류한 개발자도 앱이 어떻게 동작하는지 빠르게 파악할 수 있습니다. 관심사가 명확하게 분리되어 있어 버그의 위험이 줄고 앱의 전반적인 성능도 좋아집니다.

auth 폴더는 이런 모습이 될 수 있습니다.

```tsx
    src/
    ├── ...
    └── features/
        ├── auth/
        |   ├── api/
        |   ├── helpers/
        |   ├── hooks/
        |   ├── screens/
        |   ├── services/
        |   └── store/
        └── ... (other features)
```

features 폴더가 중요한 이유는 코드베이스를 더 작고 다루기 쉬운 단위로 나눠 주기 때문입니다. 각 기능에는 api, helpers(또는 utils), hooks, screens, services, store처럼 그 기능 전용의 하위 폴더가 있습니다. 덕분에 각 기능이 어떻게 동작하는지, 기능끼리 어떻게 상호작용하는지 이해하기가 쉬워집니다.

api 폴더에는 인증에 특화된 API 관련 코드가 모두 들어갑니다. 덕분에 API 호출을 관리하고 정리하기가 쉬워집니다.

helpers 폴더에는 인증 기능에 특화된 헬퍼 메서드나 유틸리티 함수가 들어갑니다. 이 함수들은 인증 기능 안에서만 쓰이며 앱의 다른 부분과 공유할 필요가 없습니다.

hooks 폴더에는 인증에만 관련된 훅이 들어갑니다. React는 훅에 크게 의존하므로, 이렇게 하면 훅을 관리하고 정리하기가 쉬워집니다.

screens 폴더에는 인증 기능의 화면이 모두 들어갑니다. 로그인 화면, 회원가입 화면, 비밀번호 찾기 화면 등이 여기에 포함됩니다.

services 폴더에는 인증 기능에 특화된 서비스가 들어갑니다. 예를 들어 사용자 로그인과 회원가입을 처리하는 인증 서비스가 있을 수 있습니다.

마지막으로 store 폴더에는 인증 기능에 특화된 상태 관리 코드가 들어갑니다. Redux 스토어일 수도, Zustand 스토어일 수도, 선호하는 다른 상태 관리 라이브러리일 수도 있습니다.

앱을 더 작고 정돈된 단위로 나누면 코드를 관리하고 필요할 때 수정하기가 훨씬 쉬워집니다. 코드를 깔끔하고 읽기 쉽게 유지하는 데도 도움이 되어 다른 개발자가 코드를 이해하고 작업하기도 쉬워집니다.

### auth 기능 폴더의 구조 예시

```tsx
    src/
    └── features/
        └── auth/
            ├── api/
            |   ├── login.ts
            |   ├── signup.ts
            |   └── refresh-token.ts
            ├── helpers/
            |   ├── validateToken.ts
            |   └── dataTransformer.ts
            ├── screens/
            |   ├── Login.tsx
            |   └── Signup.tsx
            ├── services/
            |   └── validation.ts
            └── store/
                └── auth.ts
```

auth 폴더는 앱의 인증 기능 전용 하위 폴더입니다. 이 폴더의 파일들은 로그인과 회원가입 API부터 사용자가 상호작용하는 UI 화면까지, 인증과 인가에 관련된 모든 것을 처리합니다.

api 폴더에는 인증 기능의 API가 들어 있습니다. 예를 들어 login.ts와 signup.ts 파일은 사용자의 로그인 및 회원가입 요청과 응답을 처리합니다. refresh-token.ts 파일은 토큰 갱신을 처리합니다.

helpers 폴더에는 인증 과정에서 쓰는 헬퍼 함수가 들어 있습니다. 예를 들어 validateToken.ts 파일은 토큰을 검증하는 데 쓰이고, dataTransformer.ts 파일은 인증 API와 주고받는 데이터를 변환합니다.

screens 폴더에는 사용자가 상호작용하는 UI 컴포넌트가 들어 있습니다. 예를 들어 Login.tsx와 Signup.tsx 파일에는 각각 사용자가 로그인하고 회원가입하는 UI 컴포넌트가 들어 있습니다.

hooks 폴더에는 인증 관련 커스텀 훅이 들어 있습니다. 예를 들어 useLoginAction.ts와 useSignupForm.ts 파일에는 각각 로그인 폼과 회원가입 폼의 상태와 동작을 관리하는 데 도움이 되는 훅이 들어 있습니다.

services 폴더에는 인증 관련 서비스가 들어 있습니다. 예를 들어 validation.ts 파일에는 사용자 입력을 검증하는 함수가 들어 있습니다.

store 폴더에는 인증 관련 상태 관리 코드가 들어 있습니다. auth.ts 파일은 Zustand, Redux 같은 상태 관리 라이브러리를 써서 인증 관련 상태와 액션을 담고 있습니다.

### 주의

> 폴더와 파일의 이름 규칙은 프로젝트마다, 개발자마다 다를 수 있다는 점을 기억하세요. 중요한 것은 각 폴더에 붙인 정확한 이름이 아니라 폴더의 구조와 정리 방식입니다. 예를 들어 앱 루트의 utils 폴더는 helpers나 utilities라고 불러도 되고, _screens_ 대신 _pages_처럼 그 프로젝트에 맞는 다른 이름을 써도 됩니다. 목표는 개발자가 코드의 구성을 이해하고, 앱을 유지보수하고 확장하기 쉽게 만드는 명확하고 일관된 구조를 갖추는 것입니다.

### 타입 기반 폴더 구조 vs 기능 기반 폴더 구조

프로젝트 코드베이스를 정리하는 또 다른 널리 쓰이는 방법은 타입 기반 폴더 구조이며, 여기에도 나름의 장단점이 있습니다. 다음 섹션에서는 두 폴더 구조를 시각적으로 비교해 보겠습니다.

### 비교

```tsx
    Feature-based folder structure:

    src/
    └── features/
        ├── auth/
        |   ├── api/
        |   │     ├── register.tsx
        |   │     ├── login.tsx
        |   │     ├── types.tsx
        |   │     └── helpers.tsx
        |   ├── helpers/
        |   ├── hooks/
        |   └── screens/
        |   │     ├── LoginScreen.tsx
        |   │     ├── SignupScreen.tsx
        |   │     ├── WelcomeScreen.tsx
        |   │     └── HomeScreen.tsx
        |   ├── services/
        |   └── store/
        ├── todo/
        |   └── screens/
        |   │    └── TodoListScreen.tsx
        |   ├── services/
        |   └── store/
        └── ... (other features)

    Type-based folder structure:

    src/
    ├── screens/
    |   ├── LoginScreen.tsx
    |   ├── SignupScreen.tsx
    |   ├── TodoListScreen.tsx
    |   ├── WelcomeScreen.tsx
    |   └── HomeScreen.tsx
    ├── api/
    |   └── auth/
    |       ├── register.ts
    |       ├── login.ts
    |       ├── types.ts
    |       └── helpers.ts
```

위에서 볼 수 있듯이 타입 기반 폴더 구조에서는 화면이 API 호출이나 헬퍼와 분리되어 있어 코드베이스를 이해하기 어려워질 수 있습니다. 타입 기반 폴더 구조에서는 LoginScreen.tsx와 TodoListScreen.tsx처럼 서로 관련 없는 화면이 같은 폴더에 들어가게 될 수 있다는 점에 주목하세요. 또한 **_관련된 코드가 한곳에 모여 있지 않기 때문에 코드를 유지보수하기도 어려워질 수 있습니다._** 반면 기능 기반 폴더 구조에서는 화면, API 호출, 헬퍼, 서비스를 포함해 인증과 관련된 모든 코드가 auth 폴더 하나에 모여 있습니다. 관련된 코드가 모두 한곳에 있으므로 코드베이스를 이해하기가 더 쉽습니다. 이 방식은 코드를 더 잘 캡슐화하고, 앞으로의 변화에 대해 프로젝트를 확장 가능하고 유연하게 만들어 줍니다.

### 기능 기반 폴더 구조의 최종 모습

아래는 기능 기반 폴더 구조에 예시 파일을 넣었을 때의 최종 모습입니다.

```tsx
    Feature-based folder structure:

    src/
    ├── components/
    │   ├── Button.tsx
    │   └── Header.tsx
    ├── hooks/
    │   └── useHeader.ts
    ├── localization/
    │   ├── languages.ts
    │   └── locales.ts
    ├── lib/
    │   ├── axios-instance.ts
    │   └── constants.ts
    ├── navigation/
    │   ├── root-navigator.tsx
    │   └── auth-stack.tsx
    ├── services/
    │   ├── notification.ts
    │   └── logging.ts
    ├── theme/
    │   └── index.ts
    ├── types/
    │   ├── env.d.ts
    │   └── react-augment.d.ts
    ├── utils/
    │   └── layout.ts
    └── features/
        ├── auth/
        │   ├── api/
        │   │   ├── login.ts
        │   │   ├── signup.ts
        │   │   └── refresh-token.ts
        │   ├── helpers/
        │   │   ├── validateToken.ts
        │   │   └── dataTransformer.ts
        │   ├── hooks/
        │   │   ├── useLoginAction.ts
        │   │   └── useSignupForm.ts
        │   ├── screens/
        │   │   ├── Login.tsx
        │   │   └── Signup.tsx
        │   ├── services/
        │   │   └── validation.ts
        │   └── store/
        │       └── auth.ts (zustand, redux, jotai etc.)
        └── ... (other features)
```

> 위의 여러 폴더에 추가한 파일들(예: components 폴더의 button.tsx, header.tsx, hooks 폴더의 useHeader.ts 등)은 예시일 뿐이며 100% 정확한 것으로 받아들이면 안 됩니다. 이 파일들을 넣은 목적은 폴더 구조를 시각적으로 보여 주고 코드베이스의 구성을 더 잘 이해하도록 돕는 것입니다. 실제 구현은 프로젝트의 구체적인 요구 사항에 따라 달라질 수 있습니다. 이 글의 초점은 개별 파일의 세부 사항이 아니라, 기능 기반 폴더 구조와 그것이 확장 가능하고 정돈된 코드베이스를 만드는 데 어떻게 도움이 되는지에 있습니다.

---

### 마치며

제 생각에 기능 기반 폴더 구조는 React/React Native 프로젝트를 정리하는 데 유용한 방식입니다. 코드를 기능별로 나누면 앱을 유지보수하고, 이해하고, 개발하기가 더 쉬워진다고 느낍니다. 이 구조는 코드를 더 잘 캡슐화해서 앞으로의 변화에 대해 프로젝트를 확장 가능하고 유연하게 만들어 줍니다. 물론 모든 경우에 들어맞는 해결책은 아니며, 정확한 구조는 프로젝트의 규모와 복잡도에 따라 달라질 수 있습니다. 하지만 핵심은 서로 다른 기능과 그 기능의 컴포넌트, 서비스, 데이터를 명확하게 분리하는 것입니다. 제 경험상 이 구조 덕분에 시간이 지나면서 성장과 변화를 감당할 수 있는, 잘 정돈된 프로젝트를 만들고 유지할 수 있었습니다. 이 방식이 도움이 될 만한 분들과 나누고 싶었습니다.

### 게시처

이 글은 다음 곳에도 게시되어 있습니다.

- [Medium](https://medium.com/gitconnected/how-to-structure-react-native-application-679e36c63efd)

