thewavelet

React Native 0.83 and Expo 55

thewavelet — Tue, 31 Mar 2026 14:50:30 +0900

Release Notes

Expo SDK 55 릴리즈 노트

2026년 2월 25일 · React Native 0.83 · React 19.2

Expo SDK 55가 출시되었습니다. 이번 릴리즈에는 React Native 0.83과 React 19.2가 포함되어 있으며, 레거시 아키텍처 지원 종료, AI 도구 확장, 네이티브 UI 개선 등 굵직한 변화가 가득합니다.

전환 기간 안내 (Expo Go)

이번 릴리즈 직후 잠시 동안, App Store / Play Store의 Expo Go는 SDK 54 버전을 유지합니다. 또한 npx create-expo-app으로 생성되는 기본 프로젝트도 일관성을 위해 잠시 SDK 54를 사용합니다.

이 전환 기간을 활용해 Development Build로 마이그레이션하는 것을 권장합니다. Development Build는 앱스토어에 배포할 앱을 만들기 위해 필요한 모든 것을 제공합니다.

SDK 55용 Expo Go 설치 방법:

Android: Expo CLI를 통해 직접 디바이스에 설치 가능
iOS: TestFlight External Beta 이용, 또는 새로운 eas go 명령어로 본인 TestFlight 팀에 업로드

SDK 55 프로젝트를 새로 만들려면: npx create-expo-app --template default@sdk-55

기본 프로젝트 템플릿 개편

기본 템플릿이 네이티브 플랫폼 관행과 개선된 폴더 구조에 초점을 맞춰 새롭게 디자인되었습니다.

Native Tabs API 기본 적용

iOS/Android에서 플랫폼 네이티브 탭 경험 제공, 브라우저에서는 반응형 웹 최적화 레이아웃 사용

✨ 새로운 디자인

기본 제공 경험(out-of-the-box) 향상을 위한 전면 디자인 리프레시

새 /src 폴더 구조

앱 코드가 이제 /app 대신 /src/app에 위치하여 프로젝트 설정 파일과 앱 코드가 명확히 분리됩니다.

새 템플릿으로 프로젝트 생성하기

# npm
npx create-expo-app@latest --template default@sdk-55

# bun
bun create expo-app --template default@sdk-55

# pnpm
pnpm create expo-app --template default@sdk-55

# yarn
yarn create expo-app --template default@sdk-55

레거시 아키텍처 지원 종료

⚠️

SDK 54에서 예고된 대로, SDK 55부터 레거시 아키텍처(Legacy Architecture)를 더 이상 사용할 수 없습니다. app.json의 newArchEnabled 설정 옵션도 제거되었습니다. 자세한 내용은 "React Native's New Architecture" 가이드를 참고하세요.

⚡

Hermes v1 옵트인 지원

Hermes v1은 JS 엔진의 큰 도약으로, 다양한 시나리오에서 성능 개선이 초기 지표에서 확인되었습니다. 또한 모던 JavaScript 기능 (ES6 클래스, const/let, async/await) 지원이 크게 향상됩니다.

⚠️

주의: SDK 55 / React Native 0.83에서 Hermes v1을 사용하려면 React Native를 소스에서 빌드해야 하므로 네이티브 빌드 시간이 크게 증가합니다. 또한 Android 모노레포 프로젝트에서는 아직 권장하지 않습니다.

expo-build-properties의 useHermesV1 필드로 활성화할 수 있습니다:

{
  "expo": {
    "plugins": [
      [
        "expo-build-properties",
        {
          "buildReactNativeFromSource": true,
          "useHermesV1": true
        }
      ]
    ]
  }
}

또한 package.json의 overrides에 hermes-compiler 버전을 지정해야 합니다:

{
  "overrides": {
    "hermes-compiler": "250829098.0.4"
  }
}

Hermes 바이트코드 Diff 업데이트 (EAS Update)

expo-updates와 EAS Update에 Hermes 바이트코드 diff 기능이 추가되었습니다. 업데이트 전체 파일을 다운로드하는 대신, 이전 버전에 대한 바이너리 패치(diff)만 다운로드하여 적용합니다.

~75%

바이트코드 다운로드 시간 단축 (iOS/Android)

↓

대역폭 사용량 절감

↑

업데이트 채택률 향상

SDK 55에서는 옵트인 방식이며, SDK 56에서 기본 활성화 예정입니다. 활성화 방법:

{
  "expo": {
    "updates": {
      "url": "https://u.expo.dev/[your-project-id]",
      "enableBsdiffPatchSupport": true
    }
  }
}

EAS 대시보드 → Update Details → Update Group에서 diff가 적용되고 있는지 확인할 수 있습니다.

Expo 개발자를 위한 AI 도구 확장

MCP: CLI 액션 및 EAS 서비스 연동

Expo 모듈이 Expo CLI에 플러그인과 명령어를 노출하면, [SHIFT] + M 메뉴에서 이 액션들을 Expo MCP 서버에 자동으로 설치할 수 있게 되었습니다.

MCP를 통해 EAS에 질의 가능 — "최근 빌드가 왜 실패했나요?" 같은 질문을 AI에게 직접 물어볼 수 있습니다.
TestFlight 크래시 리포트와 피드백도 조회 가능 (ASC 키가 Expo 계정에 연결된 경우).
예: "TestFlight에서 최근 크래시 리포트와 피드백을 분석해줘" → AI가 자동으로 조사.

Agent Skills

expo/skills 저장소는 Expo 앱 빌드·배포·디버깅을 위한 공식 AI 에이전트 스킬 컬렉션입니다. 주로 Claude Code와 함께 사용하며, Opus 모델에 최적화되어 있지만 모든 AI 에이전트에서 사용 가능합니다.

✅ 업그레이드 스킬도 포함되어 있어 SDK 55로 업그레이드할 때 도움이 됩니다. 커뮤니티에서 만든 유사 스킬들이 많지만, Expo 팀이 공식적으로 관리하는 스킬은 expo/skills 저장소의 것뿐임을 주의하세요.

"Brownfield" — 기존 네이티브 앱에 Expo 추가

SDK 55는 Brownfield 앱 지원을 개선하고, 새로운 expo-brownfield 패키지를 통해 격리된(isolated) 방식의 통합을 도입합니다.

통합 방식 (Integrated)

React Native 코드가 기존 네이티브 프로젝트 내부에 위치. 양쪽을 함께 개발하는 팀에 적합.

격리 방식 (Isolated)

React Native 앱을 네이티브 라이브러리(AAR/XCFramework)로 패키징. Node.js 환경 없이 네이티브 개발자가 사용 가능.

config 플러그인, 아티팩트 빌드용 CLI, 네이티브 ↔ Expo 앱 간 양방향 메시징 API가 포함됩니다.

Expo Router 네이티브 기능 강화

NEW Colors API

Android에 동적 Material 3 스타일, iOS에 적응형 색상을 적용. 앱 색상이 OS 테마에 자동으로 맞춰집니다.

NEW Apple Zoom 트랜지션

iOS에서 네이티브 줌 트랜지션과 제스처를 사용한 인터랙티브 공유 요소 전환 지원. 현재 iOS 전용이며 기본 활성화.

NEW Stack.Toolbar API

iOS 앱을 위한 UIToolbar API. 화면 하단 버튼으로 메뉴/액션을 수행할 때 탭 대안으로 유용. 현재 iOS 전용.

NEW SplitView 지원 (실험적)

React Native에서 오랫동안 기다려온 SplitView 레이아웃 지원. 현재 실험적 단계.

NEW Android Form Sheet 푸터 (실험적)

Android 모달 시트에 액션 버튼이나 확인 프롬프트를 위한 푸터 추가 가능.

✅ 기타 개선 사항

iOS/Android native-tabs 레이아웃에서 safe area 자동 처리 — 더 이상 수동 inset 처리 불필요
화면 동기 레이아웃 업데이트 기본 활성화 — 네비게이션 전환 시 레이아웃 점프 감소
iOS 26+: Form Sheet 헤더가 자동으로 Liquid Glass 디자인 언어 채택
Native tabs 및 헤더에서 Xcasset 아이콘 지원
react-native-screens 4.23.0으로 업그레이드

Expo UI (2026년 중반 안정화 목표)

2026년 중반 안정 버전 출시를 목표로, SDK 55에서 기능이 크게 개선되었습니다. SwiftUI와 Jetpack Compose를 위한 스킬도 expo/skills에 추가되었습니다.

Jetpack Compose Beta

Alpha에서 Beta로 승격되었습니다. 테스트 케이스로 WikiReader 클론 앱(expo/wiki-reader)이 제작되었습니다.

함수형 DSL 패턴으로 전환: 클래스 기반에서 View("MyView") { props -> } 형태로 변경
새 Material3 컴포넌트 다수 추가: Card, LazyColumn, ListItem, PullToRefreshBox, FlowRow, Surface, Icon, DockedSearchBar, FilterChip, ToggleButton, RadioButton, ModalBottomSheet, Carousel, IconButton, 웨이브 프로그레스 인디케이터
Modifier 지원: SwiftUI 스타일 modifier를 Compose 컴포넌트에 적용 가능. 예: <Box modifiers={[size(100,100), background(...)]} />
<Icon> 컴포넌트: Material Symbols XML 벡터 드로어블을 네이티브로 렌더링
Host.colorScheme으로 동적 테마 지원

SwiftUI Beta

SwiftUI 관행에 더 가깝게 API가 업데이트되었습니다. Breaking Changes 포함:

API 이름 변경: DateTimePicker → DatePicker, Switch → Toggle, CircularProgress/LinearProgress → ProgressView
새 컴포넌트: ConfirmationDialog, ScrollView
새 Modifier: contentShape(), monospacedDigit, scaleEffect(축별), ignoreSafeArea
Text 컴포넌트에서 Markdown 지원
커스텀 SwiftUI 뷰·modifier 지원 — 직접 컴포넌트와 modifier를 확장 가능

새로운 Expo SDK 패키지 버전 체계

SDK 55부터, 모든 Expo SDK 패키지의 메이저 버전이 SDK 버전과 동일하게 맞춰집니다.

예: SDK 55와 호환되는 expo-camera의 버전은 ^55.0.0입니다. 패키지 버전만 봐도 어떤 SDK 버전용인지 한눈에 알 수 있습니다.

Modules

CLIs

Updates

Builds

Expo Modules Core

iOS와 Android 모두를 위한 통합 네이티브 모듈 빌드 기반입니다. SDK 55에서의 개선 사항:

Swift 6 언어 모드 채택

네이티브 모듈 유지 관리자라면, 이제 코드의 데이터 레이스가 컴파일 타임에 검사되어 스레드 안전성 보장이 강화됩니다.

ArrayBuffer 지원 추가

JavaScript와 네이티브 코드 간에 바이너리 데이터(오디오, 이미지, 파일 등)를 효율적으로 전송할 수 있게 됩니다.

StaticFunction / StaticAsyncFunction 추가

모듈 API의 Class에서 인스턴스 생성 없이 함수를 직접 호출할 수 있습니다.

Expo CLI 개선 사항

개발 서버 시작 화면 개선: 작은 터미널에서 QR 코드가 잘리지 않도록 최적화. Alacritty, Ghostty, Kitty, Windows Terminal에서 소형 QR 코드 지원.
환경 파일 지원(@expo/env): Node.js의 빌트인 parseEnv를 사용하도록 업데이트.
개발 빌드에서 첫 로컬 네트워크 접근 안정화: iOS + expo-dev-client에 Apple Bonjour 지원 추가. iOS 첫 실행 시 개발 서버 연결 실패 문제 해결.
동적 앱 설정 로딩 개선: app.config.js 등 동적 설정 파일 로딩이 Node.js 모듈 로딩과 맞춰졌습니다. .mjs, .cjs, .cts, .mts 확장자 실험적 지원.
새 Log Box 실험적 지원: 웹에서는 기본 활성화. 모바일 개발 시 EXPO_UNSTABLE_LOG_BOX=1 설정 후 네이티브 재빌드하면 사용 가능 (Expo Go 미지원).

expo-widgets iOS 알파 릴리즈

Alpha expo-widgets를 사용하면 네이티브 코드 없이 Expo UI 컴포넌트만으로 iOS 홈 화면 위젯과 Live Activities를 만들을 수 있습니다.

위젯 타임라인 생성·업데이트 API
Live Activities 시작·관리
Push-to-start 토큰 수신 대기
레이아웃은 @expo/ui SwiftUI 컴포넌트와 modifier로 구성

expo-blur Android 안정화

Android 개발자들의 오랜 고민이었던 배경 블러가 드디어 안정화되었습니다. SDK 55부터 expo-blur는 Android 12 이상에서 훨씬 효율적인 RenderNode API를 사용하여 낮은 성능 비용으로 배경 블러를 적용합니다.

마이그레이션 필요: 블러 가능한 배경 콘텐츠를 <BlurTargetView> 래퍼로 감싸야 합니다. 기존 API는 하위 호환을 유지하므로 즉시 마이그레이션이 필요하지는 않습니다.

✨

기타 주요 업데이트

Expo Go

UI가 완전히 개선되어 SDK 54의 expo-dev-client 변경사항과 일치, Hermes 디버깅 경험 향상.

Expo Web

에러 오버레이 재작성, 서버 사이드 렌더링 알파 지원, 실험적 데이터 로더 출시.

expo-contacts/next
expo-media-library/next
expo-calendar/next

SharedObjects를 활용한 새 객체지향 API로 연락처, 이벤트, 미디어를 더 쉽게 관리. 더 강력한 쿼리 기능 추가.

expo-notifications

최신 Android Firebase 알림 의존성 업데이트. 백그라운드 작업 미실행, Android 11/12 크래시, FCM intent 검증, 커스텀 사운드 유효성 검사 등 주요 버그 수정.

expo-audio

잠금화면 컨트롤, 배경 녹음, 모든 플랫폼 플레이리스트 지원, 네이티브 프리로딩, Android 포그라운드 서비스 개선, iOS shouldRouteThroughEarpiece, 웹 지원 확대 (미터링, 녹음 입력 선택, 미디어 컨트롤).

expo-sqlite

새 SQLite Inspector DevTools 플러그인으로 실시간 DB 조회 가능. 타입 안전 파라미터 바인딩을 위한 태그드 템플릿 리터럴 API 추가: await db.sql`SELECT * FROM users WHERE age > ${age}`.

expo-crypto

AES-GCM 암호화 및 복호화 지원 추가.

expo-camera

녹화 시 영상 안정화 모드, Android 전면 카메라 스크린 플래시 추가. 앱 크기 절감을 위한 바코드 스캐너 API 제외 옵션 추가.

expo-web-browser

auth universal links 콜백 지원 추가. 앱이 백그라운드 전환 후 브라우저가 닫히는 Android 문제 수정.

expo-video

seekTolerance, scrubbingModeOptions 추가로 스크러빙 성능 향상. Android Picture-in-Picture 개선 (다중 VideoView 지원). 오디오·자막 트랙에 name, isDefault, autoSelect 필드 추가.

expo-image

iOS HDR 이미지 지원, SF Symbols 렌더링 가능, Android 쿠키 지원 (인증된 이미지 요청).

expo-server

SDK 54 주기에 @expo/server를 대체하는 새 패키지. 다양한 서버 환경과 호스팅 제공자용 어댑터 제공.

expo-file-system

파일에 데이터를 추가(append)하기 위한 쓰기 메서드에 append 옵션 추가.

expo-location

iOS 권한 응답에 정확도 인증(accuracy authorization) 포함 — 사용자가 전체 정확도 또는 제한 정확도를 허용했는지 확인 가능.

expo-maps

iOS Apple Maps에서 UI 스타일 옵션 추가 — 시스템 설정과 무관하게 라이트/다크 지도 모드 강제 설정 가능.

create-expo-module

비대화형 모드 지원 추가 — AI 에이전트 및 CI 파이프라인에서 인터랙티브 프롬프트 없이 모듈 스캐폴딩 가능.

최소 iOS 버전 예고: SDK 56에서 최소 iOS 버전이 15.1 → 16.4로 상향 예정. SDK 55의 최소 iOS 버전은 여전히 15.1입니다.

⚠️

Deprecations (지원 중단 예정)

여러 Expo 모듈의 removeSubscription 함수 deprecated — subscription.remove() 사용으로 전환.
expo-video-thumbnails deprecated — expo-video의 generateThumbnailsAsync로 대체. SDK 56에서 삭제 예정, 패치 미제공.
expo-video의 bitrate 필드 deprecated — averageBitrate, peakBitrate 사용.
expo-navigation-bar 대부분 메서드 deprecated — Android 엣지-투-엣지 의무화로 배경색, 테두리색, 동작, 위치, 버튼 스타일 API 모두 no-op. app.json의 androidNavigationBar 설정도 deprecated.
expo-status-bar의 backgroundColor, translucent, networkActivityIndicatorVisible deprecated — 엣지-투-엣지 적용으로 no-op. app.json의 androidStatusBar.backgroundColor, androidStatusBar.translucent도 deprecated.

주요 Breaking Changes

app.json의 notification 설정 필드 제거 — prebuild 시 에러 발생. expo-notifications config 플러그인으로 마이그레이션 필요.
Expo Go Android에서 푸시 알림 사용 시 에러 발생 (이전: 경고). 푸시 알림 사용을 위해서는 Development Build로 마이그레이션 필요.
앱 설정 평가 툴체인 변경 — app.config.ts가 이제 내부 도구 대신 설치된 TypeScript로 트랜스파일됨.
eas update에 --environment 플래그 필수 — CI에서 사용 시 반드시 플래그 추가.
expo-av Expo Go에서 제거 — expo-video, expo-audio로 대체되었으며, 더 이상 패치를 받지 않음.
expo-video: allowsFullscreen prop 제거 — fullscreenOptions.enable 사용.
expo-clipboard: 이벤트 리스너의 content 프로퍼티 제거 — getStringAsync() 사용.
expo-cellular: 사업자 관련 상수 제거 — iOS 메서드는 이제 null 반환.
expo-router: ExpoRequest, ExpoResponse 타입 제거 — 표준 Request/Response 사용.
app.json에서 edgeToEdgeEnabled 제거 — Android 16+ 타겟 시 엣지-투-엣지 의무화.
expo-router: headless tabs의 reset prop → resetOnFocus로 이름 변경.
expo-blur: experimentalBlurMethod → blurMethod로 이름 변경.
모노레포에서 expo.experiments.autolinkingModuleResolution 기본 활성화.
빠른 리졸버와 EXPO_USE_FAST_RESOLVER 환경 변수 제거 — 이제 리졸버 구현이 하나뿐이며 별도 설정 불필요.
experiments.reactCanary 플래그 제거 — React 19가 기본값이 되어 플래그 불필요.

도구 버전 변경

최소 Xcode 버전: 26

EAS Build는 SDK 55의 경우 기본적으로 Xcode 26.2를 사용합니다.

최소 Node.js 버전 상향

SDK 55에서 지원되는 Node.js 버전: ^20.19.4, ^22.13.0, ^24.3.0, ^25.0.0

SDK 55 업그레이드 가이드

Claude Code 또는 업그레이드 스킬을 활용하는 것을 권장합니다.

모든 의존성을 SDK 55에 맞게 업그레이드

npx expo install expo@^55.0.0 --fix

Expo Doctor로 알려진 문제 확인

npx expo-doctor@latest

중복 네이티브 모듈 경고가 보이면 가이드를 따라 해결하세요.

Deprecations 및 Breaking Changes 검토

위의 두 섹션을 반드시 확인하고, 전체 목록은 CHANGELOG를 참고하세요.

Xcode 26 업그레이드 확인

iOS 네이티브 프로젝트 컴파일에 Xcode 26이 필요합니다.

CNG(Continuous Native Generation) 사용자

이전 SDK 버전으로 생성된 android, ios 디렉터리를 삭제하세요. 다음 빌드 시 자동으로 재생성됩니다.

Development Build 사용자

업그레이드 후 새 Development Build를 생성하세요.

문제가 있으면 업그레이드 트러블슈팅 가이드를 참고하거나, 매주 수요일 오후 12시(태평양 시간) Discord 오피스 아워에 참여하세요.

한의원 추나요법, 건강보험에 실비까지 된다고요? 직접 받아보고 비용 다 정리했습니다

thewavelet — Fri, 27 Feb 2026 05:54:39 +0900

허리 디스크 진단받고 나서 정형외과 물리치료만 계속 다녔어요.

가도 가도 별로 나아지는 게 없고, 도수치료는 회당 5~8만 원씩 하니까 부담이 너무 크더라고요.

그러다 지인 추천으로 한의원 추나요법을 받아봤는데, 이게 건강보험도 되고 실비보험 청구까지 된다는 걸 그때 처음 알았어요.

당연히 비싼 비급여일 거라 생각해서 아예 알아볼 생각도 안 했거든요.

모르면 진짜 손해인 내용들, 직접 겪어보고 알게 된 거 전부 정리해드릴게요.

추나요법, 건강보험 급여 됩니다

2019년 4월부터 추나요법이 건강보험 급여 항목으로 지정됐어요.

허리 디스크, 목 디스크, 척추관협착증, 골반 틀어짐, 각종 근골격계 질환이 있는 분들은 누구나 건강보험 적용을 받을 수 있어요.

예전엔 추나 받으면 전액 본인 부담이었는데 이제는 건강보험이 절반 이상을 커버해줘요.

추나요법 종류별 가격 (2026년 기준)

추나요법은 종류에 따라 총 수가와 본인부담금이 달라요.

종류 총 수가 공단부담금 본인부담금 본인부담률

단순추나	26,330원	13,165원	13,165원	50%
복잡추나 (디스크·협착증)	44,450원	22,225원	22,225원	50%
복잡추나 (기타 근골격계)	44,450원	8,890원	35,560원	80%

복잡추나 중에서도 디스크·협착증은 50% 부담, 그 외 근골격계 질환은 80% 부담이라는 게 핵심이에요.

정형외과 도수치료 회당 5~8만 원이랑 비교하면 훨씬 저렴하죠?

연간 20회 급여 – 이게 핵심 포인트예요

추나요법 건강보험은 연간 20회까지 적용돼요.

주 1~2회씩 받으면 2~5개월 정도 건강보험으로 커버할 수 있어요. 초기 집중 치료 기간에 딱 맞아요.

참고로 건강보험 급여 추나의 경우 한의사 1인이 하루에 진료할 수 있는 인원이 18명으로 제한되어 있어요. 다만 비급여로 자비 부담해서 받는 추나는 이 카운팅에 포함되지 않아요.

20회 다 쓰고 나서도 계속 받을 수 있어요

급여 20회 소진 후엔 추나가 비급여로 전환되는데, 한의원마다 다르지만 단순추나 기준 2~4만 원대로 이어받을 수 있는 곳이 많아요.

정형외과 도수치료의 절반도 안 되는 가격이에요.

그리고 침·부항·전기치료는 추나와 완전히 별개로 건강보험 급여가 계속 적용돼요.

치료 항목 급여 여부 비고

침	급여 (횟수 제한 없음)	소액 본인부담
뜸	급여	소액 본인부담
부항	급여	소액 본인부담
전기치료 (저주파·초음파)	급여	소액 본인부담
추나요법	급여 (연 20회)	13,165~35,560원
추나요법 (20회 초과)	비급여	한의원마다 상이

여기서부터가 진짜 핵심 – 실비보험까지 됩니다

한의원 치료는 실비보험이 안 된다고 알고 계신 분들 많으시죠?

저도 그렇게 알았는데, 됩니다.

추나요법이 2019년에 급여 항목으로 바뀌면서 실비보험 청구도 가능해졌어요. 침·부항·전기치료도 마찬가지예요.

실비 적용 구조 – 이게 진짜 포인트예요

실비보험은 그날 한의원에서 발생한 급여 항목 본인부담금 전체 합산액에서 1만 원을 공제한 나머지를 환급해줘요.

즉, 추나만 따로 계산하는 게 아니라 추나 + 침 + 부항 + 전기치료 본인부담금을 다 합친 금액에서 1만 원 빼고 돌려받는 구조예요.

예를 들어 단순추나 + 침 + 부항 + 전기치료를 같이 받은 날 본인부담금 합산이 18,000원이면, 실비로 8,000원 환급 → 실질 부담 1만 원.

복잡추나(디스크·협착증)를 받은 날은 추나 본인부담금 22,225원에 침·부항 등을 더한 합산액에서 1만 원 공제 후 나머지 대부분을 환급 받을 수 있어요.

단, 질병이나 사고 치료 목적이어야 해요. 미용·다이어트 목적의 치료는 실비 청구 불가예요.

실비보험 세대별로 보장이 달라요 – 꼭 확인하세요

실비보험은 가입 시기(세대)에 따라 보장 범위가 달라요.

세대 가입 시기 추나 실비 보장

1세대	~2009년 9월	보장 범위 가장 넓음
2세대	2009년 10월~2017년 3월	가입 약관에 따라 다름, 확인 필요
3세대	2017년 4월~2021년 6월	급여 항목 실비 가능, 특약 확인
4세대	2021년 7월~	급여 항목 실비 가능, 사용량 따라 할증 가능

중요한 건 내 보험이 몇 세대인지 먼저 확인하는 거예요.

보험사 앱이나 고객센터에 전화해서 "추나요법 실비 청구 가능한지" 딱 한 번만 물어보면 돼요.

실비보험 청구 방법 – 어렵지 않아요

준비 서류

의료비 규모 필요 서류

10만 원 이하	진료비 영수증, 진료비 세부내역서, 보험금 청구서
10만 원 초과	위 서류 + 진단서 또는 진료확인서

서류는 한의원에서 다 발급해줘요. "실비 청구용 서류 일체 주세요"라고 하면 바로 챙겨줍니다.

청구 방법

보험사 모바일 앱, 홈페이지, 팩스, 우편, 지점 방문 중 편한 방법으로 하면 돼요.

청구 기한

치료 후 3년 이내에 청구하면 돼요. 예전에 받은 치료도 영수증만 있으면 소급 청구 가능한 경우가 있으니 챙겨보세요.

실비 청구 때 이것만 주의하세요

과거에 "한의원 추나는 실비 안 된다"고 들으셨던 분들

2019년 이후로 급여 항목이 됐기 때문에 이제는 달라졌어요. 예전 보험이라도 한번 더 확인해보세요. 보험 설계사도 헷갈리는 경우가 있어서 직접 보험사 고객센터에 확인하는 게 가장 정확해요.

급여 20회 초과 비급여 추나는 실비 청구가 까다로울 수 있어요. 이 부분은 가입한 보험 약관을 꼭 확인해보세요.

이런 분들이라면 지금 바로 알아보세요

허리 디스크, 목 디스크로 오래 고생하고 있는 분
정형외과 도수치료비가 너무 부담스러운 분
어깨, 무릎, 골반 통증이 있는 분
치료비 걱정에 꾸준한 치료를 못 받고 있는 분
실비보험 가지고 있는데 한의원 치료에 쓸 수 있는지 몰랐던 분

정리하면 이렇습니다

추나요법은 건강보험으로 연 20회, 단순추나 기준 본인부담 13,165원에 받을 수 있어요. 그리고 그날 받은 침·부항·전기치료까지 포함한 본인부담금 합산액에서 1만 원만 내고 나머지는 실비보험으로 돌려받을 수 있는 구조예요.

건강보험 + 실비보험을 제대로 활용하면, 정형외과 도수치료에 수십만 원 쓰던 비용을 한의원에서 훨씬 저렴하게 해결할 수 있어요.

모르면 손해, 아는 만큼 아끼는 거예요.

본 포스팅은 개인 경험과 보건복지부 건강보험 공식 정책 정보를 바탕으로 작성된 정보성 글입니다. 실제 치료비 및 실비보험 보장 여부는 한의원 및 가입 보험 약관에 따라 다를 수 있으므로, 치료 전 반드시 확인하시기 바랍니다.

임플란트 비용 얼마가 적당할까? 2026년 최신 가격 총정리 (보험 적용·덤핑 주의까지)

thewavelet — Thu, 26 Feb 2026 18:33:31 +0900

2026년 임플란트 평균 비용은 80만~180만 원. 65세 이상 건강보험 적용 시 30만~40만 원대 가능. 재료별 가격 차이, 덤핑 치과 구별법, 치과 선택 기준까지 한 번에 정리했습니다.

임플란트, 도대체 얼마가 '정상 가격'일까?

치과 앞을 지나다 보면 "임플란트 69만 원!", "임플란트 특가 49만 원!" 같은 현수막을 자주 보게 된다. 그런데 주변에서 임플란트를 했다는 지인은 150만 원을 냈다고 하고, 인터넷에는 30만 원짜리 광고도 보인다. 도대체 어느 가격이 맞는 걸까.

결론부터 말하면 2026년 기준 임플란트 1개의 전국 평균 비용은 약 115만~140만 원 수준이다. 하지만 건강보험심사평가원이 공개한 실제 비급여 진료비를 보면 최저 55만 원에서 최고 461만 원까지, 같은 시술인데 무려 8배 이상의 가격 차이가 난다.

이 글에서는 그 이유가 무엇인지, 어느 가격대가 합리적인지, 그리고 보험은 어떻게 활용할 수 있는지를 정리해 드린다.

2026년 임플란트 가격 — 재료별 정리

임플란트는 크게 세 가지 부품으로 구성된다. 뼈에 심는 픽스처(인공치근), 픽스처와 치아를 연결하는 어버트먼트, 겉으로 보이는 **크라운(보철물)**이다. 이 중 크라운 재료가 가격을 가장 크게 좌우한다.

크라운 재료 평균 가격 (1개 기준) 특징

지르코니아	약 114만 원	자연치아와 색상 유사, 내구성 우수, 가장 많이 선택
PFM (금속+도자기)	약 100만~120만 원	오래된 방식, 건강보험 기준 재료
골드 (금)	약 156만 원	내구성 최고, 가격 높음
PFG (금+도자기)	약 183만 원	심미성+내구성 모두 높음, 최고가

2025년 건강보험심사평가원 비급여 진료비 자료 기준. 지르코니아는 전년 대비 1.8% 하락, 금 포함 재료는 소폭 인상됐다.

합리적인 가격대는 얼마일까? 전문가들이 공통적으로 말하는 적정 가격은 80만~120만 원 선이다. 이 범위 내에서 국산 브랜드(오스템, 덴티움, 디오 등)를 사용하면 품질과 가격의 균형을 맞출 수 있다. 이보다 훨씬 싸다면 재료 품질이나 포함 항목을 꼼꼼히 확인해야 한다.

왜 치과마다 가격이 이렇게 다를까? — 5가지 이유

1. 임플란트 브랜드 (국산 vs 수입)

국산 임플란트(오스템, 덴티움 등)는 기술력이 상향 평준화되어 있어 합리적인 가격에 좋은 품질을 제공한다. 수입 브랜드(스트라우만, 노벨바이오케어 등)는 재료비만 2~3배 이상 비싸다. 대부분의 케이스에서 국산으로도 충분하지만, 특수한 케이스에서는 수입 브랜드를 권하는 경우도 있다.

2. 크라운 재료

앞서 설명한 것처럼 어떤 재료를 쓰느냐에 따라 기본 가격이 달라진다. 광고에 표시된 '저가 임플란트'는 대부분 기본 재료(PFM) 기준이며, 지르코니아로 업그레이드하면 추가 금액이 붙는 경우가 많다.

3. 뼈이식·추가 수술 여부

잇몸뼈가 부족하면 뼈이식(골이식술)이나 상악동 거상술 같은 추가 수술이 필요하다. 이 비용은 별도로 청구되며, 30만~100만 원 이상 추가될 수 있다. 광고에 표시된 가격에 이 비용이 포함되어 있는지 반드시 확인해야 한다.

4. 병원 위치와 규모

서울 강남, 대형 치과병원은 같은 재료를 써도 기본 단가가 높다. 임대료, 인건비, 장비 비용 등 운영비가 가격에 반영되기 때문이다.

5. 의사의 경력과 사후관리

임플란트는 시술 난이도보다 정확한 위치 선정과 사후관리가 성공을 좌우한다. 경험 많은 의사와 탄탄한 A/S 보증이 포함된 곳은 단가가 높을 수밖에 없다.

65세 이상이라면 꼭 알아야 할 — 건강보험 적용 제도

조건 요약

만 65세 이상이라면 임플란트 건강보험 혜택을 받을 수 있다. 핵심 조건은 두 가지다.

✅ 만 65세 이상 (생일이 속한 해의 다음 해 1월 1일부터 적용) ✅ 자연치아가 1개 이상 남아있는 부분 무치악 상태 (완전 무치악은 틀니 대상)

위 두 조건을 모두 충족하면, 평생 2개까지 건강보험을 적용받아 시술비의 30%만 본인이 부담하면 된다.

실제 본인부담금은?

임플란트 1개 총 진료비가 약 120만 원이라고 가정하면 이렇게 된다.

대상 본인부담률 실제 부담금 (120만 원 기준)

일반 건강보험 가입자 (65세 이상)	30%	약 36만~40만 원
의료급여 2종 수급자	20%	약 24만 원
의료급여 1종 수급자	10%	약 12만~13만 원
65세 미만 (비보험)	100%	전액 본인 부담

주의사항 — 이것만큼은 꼭 확인하자

뼈이식, 상악동 거상술은 비급여 항목으로 건강보험 미적용 → 별도 비용 전액 본인 부담
건강보험 기준 보철물은 PFM 재료. 지르코니아 선택 시 차액 발생 가능
시술 시작한 치과에서 중간에 다른 치과로 이동하면 보험 적용 불가 (폐업 등 불가피한 경우 제외)
건강보험 임플란트는 등록된 치과에서만 시술 가능. 시술 전 치과에서 공단 등록 여부 확인 필수

"임플란트 69만 원" 광고, 믿어도 될까? — 덤핑 치과 구별법

최근 보건복지부와 치과계가 공동으로 경고하는 문제가 있다. 바로 덤핑 치과다. 지나치게 낮은 가격으로 환자를 유인한 뒤, 갑자기 폐업하거나 추가 비용을 청구하는 사례가 늘고 있다.

아래 항목 중 하나라도 해당되면 주의가 필요하다.

주의해야 할 신호들

시중 평균 대비 절반 이하의 가격을 광고하는 곳
가격에 포함된 항목(픽스처, 어버트먼트, 크라운 모두 포함인지)을 명확히 설명하지 않는 곳
뼈이식 필요 여부를 상담 전에 미리 확인하지 않는 곳
A/S(보증) 기간과 조건을 서면으로 제공하지 않는 곳
임플란트 전문의 자격이나 경력을 확인할 수 없는 곳

합리적인 치과 고르는 법 가격만 보고 결정하는 것은 위험하다. 보건복지부는 "여러 곳을 방문해 가격을 비교하고, 기타 비용이 포함되어 있는지 반드시 물어보라"고 안내한다. 실제로 치료비의 30%는 의사 기술료, 30%는 재료비, 나머지는 운영 비용으로 구성되기 때문에, 지나치게 낮은 가격은 어딘가를 줄인다는 의미일 수 있다.

임플란트 시술 과정 — 얼마나 걸릴까?

처음 임플란트를 고민하는 분들이 가장 많이 묻는 것 중 하나가 기간이다. 일반적인 흐름은 이렇다.

1단계 — 발치 및 준비 (1~2개월) 기존 치아를 뽑고 잇몸이 아물길 기다린다. 뼈이식이 필요한 경우 이 기간이 더 길어진다.

2단계 — 픽스처 식립 (시술 당일) 티타늄 인공치근을 잇몸뼈에 심는다. 수면 마취나 국소 마취 후 진행하며 30분~1시간 소요.

3단계 — 골유착 대기 (3~6개월) 인공치근이 뼈와 단단히 결합되는 기간이다. 이 기간이 임플란트 전체 과정에서 가장 길다.

4단계 — 보철물 장착 (2~3회 내원) 인공치아(크라운)를 제작해 연결한다.

전체 기간은 빠르면 3~4개월, 뼈이식 등 추가 시술이 있으면 6개월~1년까지 걸릴 수 있다.

임플란트 vs 브릿지 vs 틀니 — 비용과 장단점 비교

치아를 잃었을 때 선택지는 임플란트만이 아니다. 각각의 특징을 비교해보면 선택이 쉬워진다.

구분 임플란트 브릿지 틀니

초기 비용	80만~180만 원/개	50만~120만 원	30만~80만 원
수명	10~20년 이상	7~10년	5~7년
인접치아 손상	없음	있음 (양쪽 치아 삭제)	없음
편의성	자연치아와 동일	양호	불편함
뼈 손실 예방	가능	불가능	불가능
건강보험	65세 이상 2개	일부 적용	65세 이상 적용

장기적으로 보면 임플란트가 가장 비용 효율이 높다. 틀니는 초기 비용이 적지만 교체 주기가 짧고 생활 불편이 크다.

치과 선택 전 꼭 해야 할 3가지

1. 최소 2~3곳 상담 후 비교 같은 치아 상태를 놓고도 진단과 치료 계획, 가격이 다를 수 있다. 한 곳의 말만 듣고 결정하지 말고 비교 상담을 해보자.

2. 포함 항목 서면으로 확인 픽스처, 어버트먼트, 크라운이 모두 포함된 가격인지, 뼈이식 비용은 별도인지, A/S 조건은 어떻게 되는지를 반드시 확인하고 서면으로 받아두자.

3. 치과 전문의 자격 확인 구강악안면외과 전문의나 보철과 전문의 자격이 있는 의사에게 시술받으면 복잡한 케이스에서도 더 안전하다. 치과 홈페이지나 건강보험심사평가원 병원 정보에서 확인할 수 있다.

마무리 — 가격보다 중요한 것

임플란트는 일생에 몇 번 하기 힘든 시술이다. 가격이 중요한 것은 사실이지만, 지나치게 싼 곳을 쫓다가 재시술 비용이 더 드는 경우도 많다. 80만~120만 원 선에서, 포함 항목을 명확히 설명해주고, A/S를 보장하는 치과를 선택하는 것이 결국 가장 경제적인 선택이다.

65세 이상이라면 건강보험 혜택을 꼭 챙기고, 뼈이식 필요 여부를 먼저 확인한 뒤 전체 비용을 파악해 결정하길 권한다.

⚠️ 본 글은 정보 제공을 목적으로 작성되었습니다. 개인의 구강 상태에 따라 치료 방법과 비용이 다를 수 있으므로, 정확한 진단과 비용은 반드시 치과 전문의와 직접 상담하시기 바랍니다.

리니지 클래식 완벽 정리 — 2026년 2월 출시, 월정액·직업·논란까지 한 번에

thewavelet — Thu, 26 Feb 2026 18:19:19 +0900

2026년 2월 7일 출시된 리니지 클래식 완벽 정리! 월정액 29,700원, 군주·기사·요정·마법사 4직업 특징, 공성전·혈맹 시스템, 논란까지 솔직하게 담았습니다.

"린저씨들, 집결"… 아덴 대륙이 2026년에 다시 열렸다

PC방에서 밤을 새우며 공성전을 뛰던 그 시절. 채팅창에 "혈맹 가입 구합니다"를 치며 처음 만난 사람들과 어느새 전우가 되던 경험. 2000년대 초반 한국 게임 문화를 상징했던 리니지가 그 시절 모습 그대로 돌아왔다.

엔씨소프트가 2026년 2월 7일, 공개 발표 이후 무려 5년을 기다리게 했던 리니지 클래식을 마침내 출시했다. 출시 직후 동시접속자 32만 명, 누적 매출 400억 원 돌파, 유튜브 누적 조회수 1억 4,700만 회. 숫자가 말해주듯, 이 게임을 기다린 사람은 생각보다 훨씬 많았다.

이 글에서는 리니지 클래식이 무엇인지, 어떻게 즐기면 되는지, 그리고 논란은 무엇인지까지 있는 그대로 정리해 드린다.

리니지 클래식이란?

리니지 클래식은 엔씨소프트가 1998년부터 서비스해온 원조 리니지의 2000년대 초반 버전을 2026년 기술로 재현한 PC MMORPG다. 정확히는 리니지 2.0 버전을 기반으로 제작되었다.

핵심 철학은 단순하다. 자동 사냥도, 화려한 스킬 연출도, 복잡한 성장 시스템도 없던 그 시절로 돌아가는 것. 유저가 직접 컨트롤하고, 채팅으로 소통하고, 혈맹원들과 함께 성을 지키던 그 낭만을 다시 꺼내 들겠다는 선언이다.

서비스 지역은 한국, 대만, 홍콩, 마카오이며 PC 전용으로만 즐길 수 있다. 모바일 버전은 제작되지 않는다.

요금제 — 월정액 29,700원, 이게 얼마나 의미 있는 숫자냐면

리니지 클래식의 요금제는 월정액 29,700원이다. 이 금액이 특별한 이유가 있다. 바로 1998년 리니지 출시 당시와 동일한 가격이기 때문이다. 28년의 물가 상승을 무시하고 그 시절 요금을 그대로 가져왔다는 점에서, 개발진 나름의 복고 정신이 담겨 있다.

비교해 보면 이렇다.

게임 월정액

리니지 클래식	29,700원
월드 오브 워크래프트	약 18,000~22,000원
파이널 판타지 14	약 18,000~20,000원

같은 정액제 MMORPG와 비교하면 만 원 정도 비싼 편이다. 부분 유료화 게임에 익숙해진 요즘 기준으로는 부담스럽게 느껴질 수도 있다. 하지만 월정액 요금제의 핵심은 **"한 번 내면 모두가 동등한 출발선"**이라는 데 있다. 과금으로 강해지는 구조가 아니기 때문이다. (단, 뒤에서 설명할 논란도 있으니 끝까지 읽어보길 권한다.)

4대 직업 완벽 정리 — 군·기·요·마

리니지 클래식의 직업은 딱 4가지다. 다크엘프 이후에 추가된 직업은 등장하지 않는다. 복잡한 파생 직업 없이 각자의 역할이 명확한, 리니지 원조의 그 구성이다.

군주 — 혈맹을 이끄는 지도자

리니지에서 혈맹(길드)을 창설할 수 있는 유일한 직업이다. 군주 없이는 공성전 선전포고도, 혈맹 아지트 구매도 불가능하다. 레벨 5부터 혈맹 창설, 레벨 25부터 공성전 참가가 가능하다.

단, 전투 능력은 솔직히 떨어진다. 사냥도 느리고 PvP도 약하다. 조직을 꾸리고 사람들과 소통하는 데서 재미를 찾는 유저에게 어울리는 직업이다.

기사 — 리니지를 대표하는 올라운더

사냥, PK, 보스전 모두 무난하게 잘하는 올라운더다. 리니지 역사에 이름을 남긴 유저 '빛', '포세이든'도 기사를 선택했을 만큼 이 게임을 상징하는 직업이다. 컨트롤도 상대적으로 간단하고 생존력도 좋아 처음 시작하는 유저에게 가장 추천된다.

요정 — 원거리 딜러 + 채집·제작

활을 사용하는 원거리 딜러로, 이동하면서 공격하는 독특한 전투 방식이 특징이다. 요정만의 채집·제작 시스템이 있어 경제 활동을 즐기는 유저에게도 매력적이다. '엔트 노가다'로 자금을 모을 수 있다는 점도 포인트.

마법사 — 전장의 게임 체인저

개인 전투보다 집단전에서 진가를 발휘하는 직업이다. 앱솔루트 배리어(10초 이상 무적), 디스인티그레이트, 인비저빌리티 등 독특하고 강력한 스킬들이 전장의 흐름을 바꾼다. 공성전에서 가장 각광받는 직업 중 하나다. 다만 스킬 활용 타이밍과 빠른 손이 요구된다.

핵심 콘텐츠 — 혈맹과 공성전

리니지 클래식의 핵심은 개인 성장이 아니라 집단전이다.

혈맹은 군주를 중심으로 같은 목표를 가진 유저들이 모이는 조직이다. 군주, 부군주, 수호기사, 정예, 일반, 수련의 6단계 계급이 있으며 각 계급에 따라 권한이 다르게 설정된다.

공성전은 성을 차지하기 위해 혈맹과 혈맹이 전면전을 벌이는 콘텐츠다. 리니지 클래식의 꽃이자 존재 이유이기도 하다. 출시 시점에는 켄트성 공성전이 먼저 오픈되며, 이후 하이네, 오렌, 아덴 등 추가 영지가 순차적으로 열릴 예정이다.

현재 오픈된 주요 지역은 말하는 섬, 글루디오 영지, 기란 지역이다.

출시 성적 — 숫자로 보는 반응

출시 후 리니지 클래식은 동시접속자 32만 명과 누적 매출 400억 원을 돌파했으며, 2월 25일 기준 PC방 점유율 9.63%로 국내 서비스 중인 PC 게임 중 2위를 기록했다. 유튜브 누적 조회수도 1억 4,700만 회를 넘어섰다. 오랜 기다림이 무색하지 않은 성적이다.

논란도 솔직하게 — 알고 들어가자

좋은 점만 쓰면 광고글이다. 출시 전후로 몇 가지 논란이 있었으니 알고 시작하는 게 좋다.

유료 패스 논란 (→ 해결됨) 출시 직전인 1월 20일, 운영진이 유료 시즌 패스 판매 계획과 다중 클라이언트 허용 방침을 공지하면서 유저들의 거센 반발을 샀다. "스탯을 돈 받고 팔겠다는 것 아니냐"는 비판이 쏟아졌고, 16시간 만에 운영진이 시즌 패스의 유료 보상 부분을 삭제하겠다고 번복했다. 민심에 빠르게 반응했다는 점은 긍정적이나, 초기 방침 자체가 '클래식'의 정신에 맞지 않았다는 비판은 여전히 남아있다.

정식 서비스 하루 만에 자동 사냥·확률형 캐시템 등장 정액제 게임이라는 기대와 달리, 유료 서비스 시작 하루 만에 자동 사냥 허용과 확률형 캐시 아이템이 등장했다는 반응이 나왔다. 구 유저들 사이에서 "프리서버 같다"는 평가도 있다.

신규 유저의 진입 장벽 2000년대 초반 감성을 그대로 재현한 만큼, 당시 게임을 경험하지 않은 신규 유저에게는 불친절하게 느껴질 수 있다. 애니메이션 프레임이 적고, 편의 기능이 부족하다는 피드백이 있다.

이런 이슈들을 알고도 "그게 리니지지"라고 생각한다면, 이 게임은 당신을 위한 게임이다.

이런 분들에게 추천

2000년대 초반 PC방에서 리니지를 해봤던 30~40대 게이머
자동 사냥 없이 직접 컨트롤하며 성장하는 하드코어 MMORPG를 원하는 분
혈맹 활동, 공성전 등 집단전의 재미를 원하는 분
과금 경쟁 없이 월정액 하나로 동등하게 즐기고 싶은 분
정통 MMORPG를 처음 경험해 보고 싶은 20대

한 줄 요약

리니지 클래식은 단순한 추억팔이가 아니다. 자동화와 과금 경쟁에 지친 게이머들에게, "게임이 원래 이런 거였잖아"를 다시 보여주려는 시도다. 완벽하진 않지만, 출시 직후의 동시접속자 32만 명이라는 숫자가 이 게임의 가능성을 충분히 말해준다.

아덴 대륙의 문은 이미 열렸다.

※ 본 글의 수치 및 정보는 2026년 2월 기준이며, 업데이트에 따라 변경될 수 있습니다.

스픽(Speak) 앱 솔직 후기 — AI랑 영어로 실제로 말하는데 한 달에 만원대?

thewavelet — Thu, 26 Feb 2026 17:48:55 +0900

스픽(Speak) 앱의 핵심 기능, 가격, 장단점을 솔직하게 정리했습니다. OpenAI 기반 AI와 실시간 영어 회화 연습이 가능한 스픽, 다른 앱과 비교해 왜 가성비가 뛰어난지 알아보세요.

영어 공부 20년인데 왜 아직도 입이 안 떨어질까?

토익 800점은 넘는데, 외국인 앞에만 서면 머리가 하얘지는 경험. 누구나 한 번쯤 해봤을 거다. 문제는 우리가 영어를 '읽고 쓰는 것' 위주로만 배웠다는 데 있다. 말하는 연습을 거의 안 했으니 입이 안 떨어지는 게 당연하다.

그런데 요즘 스픽(Speak) 이라는 앱이 이 고민을 제법 빠르게 해소해주고 있다는 얘기가 많다. 실제로 국내 누적 다운로드 500만 건을 돌파했고, 앱스토어 교육 카테고리 1위를 꾸준히 유지하고 있다. 무엇이 이 앱을 이토록 많은 사람들이 쓰게 만드는 걸까.

스픽(Speak)이란?

스픽은 미국 샌프란시스코에 본사를 둔 스타트업 Speakeasy Labs가 개발한 AI 기반 영어 스피킹 앱이다. 이름 그대로, '말하기(Speak)'에 모든 기능이 집중되어 있다.

가장 주목할 포인트는 OpenAI와의 공식 기술 파트너십이다. 스픽은 ChatGPT를 만든 OpenAI의 스타트업 펀드로부터 380억 원 규모의 투자를 유치했고, GPT 기반의 언어 모델을 영어 회화 학습에 최적화해서 탑재했다. 단순히 ChatGPT에 "영어로 대화해줘"라고 치는 것과는 차원이 다른, 학습에 특화된 AI 경험을 제공한다.

핵심 기능 4가지

1. 오늘의 수업 (Daily Lesson)

매일 새로운 수업이 제공된다. LA 현지 원어민 튜터가 영상으로 등장해 그날 배울 문장을 설명하고, 사용자가 직접 그 문장을 발음해보는 식이다. 한 수업은 '오늘의 수업 → 스피킹 연습 → 실전 대화' 3단계로 구성된다.

20분 안에 무려 100문장을 직접 발화하도록 설계되어 있다. 수동적으로 강의를 듣는 게 아니라, 쉴 새 없이 말을 시킨다. 처음엔 좀 힘들게 느껴질 수 있지만, 그게 정확히 스픽의 의도다.

2. 프리톡 (AI 자유 대화)

스픽의 가장 독보적인 기능. 주제를 정하거나 상황을 설정하면 AI와 실시간으로 자유롭게 영어 대화를 나눌 수 있다. "레스토랑에서 주문하기", "낯선 사람과 스몰톡 하기" 등 실생활 시나리오로 연습이 가능하다.

이게 왜 저렴하게 가능한가? 바로 AI 덕분이다. 화상영어 플랫폼은 원어민 강사의 시간에 비용을 지불하는 구조라 1시간에 4~8만 원 선이다. 스픽은 AI가 24시간 무제한으로 대화 상대가 되어주기 때문에, 연간 구독료를 12개월로 나누면 월 1만 원대에 무제한 AI 회화 연습이 가능해진다.

3. 스픽 튜터 (AI 개인 선생님)

단순 대화를 넘어, 개인 과외 선생님 역할을 한다. 내가 틀린 발음, 어색한 표현, 자주 실수하는 문법 패턴을 분석해서 맞춤 피드백을 주고 추가 레슨까지 생성해 준다.

"영어 면접 준비해줘", "오픽 IM 등급 올리고 싶어"처럼 구체적인 목표를 말하면, 그에 맞는 커리큘럼을 직접 설계해서 제안한다. 내 영어 수준, 관심사, 목표를 기반으로 온전히 나만을 위한 학습 플랜이 나온다.

4. 음성 인식 피드백

스픽의 음성 인식 기술은 0.1초 이내, 95% 이상의 정확도로 한국인의 영어 발음을 인식한다고 알려져 있다. 발음이 어색하거나 틀렸을 때 즉각적으로 교정해주기 때문에, 잘못된 발음이 굳어지는 것을 방지한다. 화면을 터치하거나 조작하지 않아도 자연스럽게 대화가 이어지는 것도 실제 대화하는 느낌을 높여준다.

가격 정보 (2025~2026년 기준)

스픽은 기본적으로 연간 구독 방식이다. 월 구독도 앱 내 인앱결제로 가능하지만, 할인이 없어 비싸기 때문에 실제로 이용하는 사람은 거의 없다.

요금제 연간 정가 월 환산

프리미엄	129,000원	약 10,750원/월
프리미엄 플러스	299,000원	약 24,916원/월
평생 이용권	약 450,000원	—

공식 파트너 링크나 할인 코드를 이용하면 2~7만 원 추가 할인이 적용된다. 블랙프라이데이, 연초 이벤트 기간에는 최대 7만 원까지 할인되는 경우도 있다.

두 요금제의 차이는?

프리미엄: 프리톡(AI 자유 대화) 무제한 + 스픽 튜터 제한 사용
프리미엄 플러스: 프리톡 무제한 + 스픽 튜터 무제한 + AI 레슨 리뷰 + Vocab 레슨 + 30일 습관 완성 프로그램

AI와의 자유 대화를 집중적으로 활용하고 싶은 사람, 혹은 맞춤 레슨을 자주 쓸 것 같은 사람이라면 플러스가 낫다. 커리큘럼 위주로 공부하는 사람이라면 프리미엄으로 충분하다.

다른 앱이나 서비스와 비교하면?

비교 항목 스픽 (프리미엄) 화상영어 듀오링고

월 비용	약 10,750원	40,000~80,000원	무료~약 15,000원
AI 회화	✅ 무제한	❌ (원어민)	❌
발화량	매우 많음	중간	적음
24시간 이용	✅	❌	✅
스피킹 특화	✅	✅	❌

화상영어의 퀄리티를 완전히 대체하긴 어렵다. 하지만 가성비와 접근성만 놓고 보면, 시간·장소 제약 없이 AI와 무제한으로 말하기 연습을 할 수 있는 앱은 현재 스픽이 독보적이다.

솔직한 장단점

장점

말을 아주 많이 시킨다 — 실제로 스피킹이 는다
OpenAI 기반이라 자연스러운 대화 흐름
월 1만 원대 가격에 무제한 AI 회화
LA 원어민이 제작한 실용적인 커리큘럼
초급부터 고급까지 수준별 콘텐츠

단점

연간 일시불 구매 방식 (월 구독은 비쌈)
AI 대화가 아직 완벽한 원어민 수준은 아님
읽기·쓰기·문법 공부는 약한 편 (스피킹 특화 앱이라서)
7일 무료체험 후 환불 정책이 다소 까다로움 (결제 전 확인 필수)

이런 분들에게 추천

토익은 잘 보는데 회화에서 막히는 직장인
해외여행 전 기초 회화를 빠르게 끌어올리고 싶은 분
화상영어는 부담스럽고, 혼자 공부하면 말할 기회가 없는 분
오픽, 토익스피킹, 영어 면접을 준비 중인 분
매일 꾸준히 짧게(20~30분) 습관을 만들고 싶은 분

마무리

스픽이 500만 다운로드를 넘긴 이유는 단순하다. "말을 많이 시킨다"는 단순한 철학을 OpenAI 기술력으로 구현했기 때문이다. 영어 공부는 결국 얼마나 많이 입을 열어봤느냐의 싸움인데, 스픽은 그 환경을 가장 저렴하고 편리하게 만들어 준다.

7일 무료체험이 가능하니, 한 번쯤 직접 써보고 판단하는 걸 추천한다.

※ 가격 정보는 2025~2026년 초 기준이며, 프로모션에 따라 변동될 수 있습니다. 결제 전 공식 홈페이지에서 최신 가격을 확인하세요.

TypeScript 실무 개발 가이드 (2025)

thewavelet — Sun, 28 Sep 2025 16:25:13 +0900

TypeScript 실무 개발 가이드 (2025)

이 문서 하나만 보면 TypeScript를 제대로 사용할 수 있도록 핵심만 정리한 실용적인 가이드입니다.

환경 설정

프로젝트 시작하기

# 새 프로젝트 생성
npm init -y
npm install typescript @types/node
npx tsc --init

# 글로벌 설치 (IDE 지원용)
npm install -g typescript

필수 tsconfig.json 설정

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ESNext",
    "lib": ["ES2020", "DOM"],
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "resolveJsonModule": true,
    "allowSyntheticDefaultImports": true,
    "moduleResolution": "node"
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules", "dist"]
}

핵심 타입 시스템

기본 타입 (매일 사용)

// 원시 타입
const name: string = "김개발";
const age: number = 30;
const isActive: boolean = true;
const nothing: null = null;
const notDefined: undefined = undefined;

// 배열과 튜플
const numbers: number[] = [1, 2, 3];
const fruits: Array<string> = ["apple", "banana"];
const coordinates: [number, number] = [10, 20];

// 리터럴 타입 (매우 유용!)
type Status = "pending" | "completed" | "failed";
type Theme = "light" | "dark";
const currentStatus: Status = "pending";

Union과 Intersection 타입

// Union 타입 (OR 관계)
type StringOrNumber = string | number;
type RequestState = "idle" | "loading" | "success" | "error";

// Intersection 타입 (AND 관계)
type User = {
  id: string;
  name: string;
};

type Admin = {
  permissions: string[];
};

type AdminUser = User & Admin; // 두 타입 모두 포함

// 실무 예시
function formatValue(value: string | number): string {
  if (typeof value === "string") {
    return value.toUpperCase();
  }
  return value.toFixed(2);
}

인터페이스와 타입 정의

인터페이스 (객체 모델링의 핵심)

// 기본 인터페이스
interface User {
  readonly id: string;      // 읽기 전용
  name: string;
  email?: string;           // 선택적 속성
  age: number;
  [key: string]: any;       // 인덱스 시그니처
}

// 확장 가능
interface AdminUser extends User {
  permissions: string[];
  lastLogin: Date;
}

// 함수 인터페이스
interface EventHandler<T> {
  (event: T): void;
}

// 실무 API 응답 모델링
interface ApiResponse<T> {
  data: T;
  status: number;
  message: string;
  success: boolean;
}

interface PaginatedResponse<T> extends ApiResponse<T[]> {
  pagination: {
    page: number;
    limit: number;
    total: number;
  };
}

Type Alias vs Interface

// Type - 더 유연함
type ButtonSize = "small" | "medium" | "large";
type APIStatus = 200 | 404 | 500;

// Interface - 확장성이 좋음 (선택의 기준: 확장 필요성)
interface ButtonProps {
  size: ButtonSize;
  variant: "primary" | "secondary";
  children: React.ReactNode;
}

// 함수 타입
type AsyncFunction<T> = () => Promise<T>;
type EventCallback = (data: any) => void;

제네릭 활용

기본 제네릭 (재사용성의 핵심)

// 기본 제네릭 함수
function identity<T>(arg: T): T {
  return arg;
}

// 실무에서 자주 사용하는 패턴
function createApiCall<TRequest, TResponse>(
  url: string,
  transform?: (data: any) => TResponse
) {
  return async (data: TRequest): Promise<TResponse> => {
    const response = await fetch(url, {
      method: 'POST',
      body: JSON.stringify(data)
    });
    const result = await response.json();
    return transform ? transform(result) : result;
  };
}

// 사용 예시
const loginApi = createApiCall<
  { email: string; password: string },
  { token: string; user: User }
>('/api/login');

제네릭 제약조건

// keyof로 객체 키 제한
function getProperty<T, K extends keyof T>(obj: T, key: K): T[K] {
  return obj[key];
}

// 타입 제약
interface Lengthwise {
  length: number;
}

function logLength<T extends Lengthwise>(arg: T): T {
  console.log(arg.length);
  return arg;
}

// 실무 예시: 폼 데이터 처리
interface FormField {
  value: any;
  error?: string;
  touched: boolean;
}

function createFormState<T extends Record<string, any>>(
  initialData: T
): Record<keyof T, FormField> {
  const formState = {} as Record<keyof T, FormField>;

  for (const key in initialData) {
    formState[key] = {
      value: initialData[key],
      touched: false
    };
  }

  return formState;
}

️ 타입 가드와 안전성

내장 타입 가드

// typeof 가드 (원시 타입용)
function processValue(value: string | number): string {
  if (typeof value === "string") {
    return value.toUpperCase(); // TS가 string임을 알고 있음
  }
  return value.toFixed(2); // TS가 number임을 알고 있음
}

// instanceof 가드 (클래스용)
class NetworkError extends Error {
  constructor(public statusCode: number, message: string) {
    super(message);
  }
}

function handleError(error: Error | NetworkError) {
  if (error instanceof NetworkError) {
    console.log(`Network error: ${error.statusCode}`);
  } else {
    console.log(`General error: ${error.message}`);
  }
}

// in 연산자 (객체 속성용)
interface Bird {
  fly(): void;
}

interface Fish {
  swim(): void;
}

function move(animal: Bird | Fish) {
  if ("fly" in animal) {
    animal.fly();
  } else {
    animal.swim();
  }
}

커스텀 타입 가드 (매우 유용!)

// 사용자 정의 타입 가드
function isString(value: unknown): value is string {
  return typeof value === "string";
}

function isUser(obj: any): obj is User {
  return obj &&
         typeof obj.id === "string" &&
         typeof obj.name === "string";
}

// 실무 예시: API 응답 검증
function isApiSuccess<T>(response: any): response is ApiResponse<T> {
  return response &&
         response.success === true &&
         response.data !== undefined;
}

// 사용
async function fetchUserData(id: string) {
  const response = await fetch(`/api/users/${id}`);
  const data = await response.json();

  if (isApiSuccess<User>(data)) {
    // data.data는 User 타입으로 안전하게 사용 가능
    return data.data;
  }

  throw new Error("Invalid API response");
}

️ 유틸리티 타입

내장 유틸리티 타입 (필수!)

interface Todo {
  id: string;
  title: string;
  completed: boolean;
  priority: "high" | "medium" | "low";
  createdAt: Date;
}

// Partial - 모든 속성을 선택적으로
type TodoUpdate = Partial<Todo>;
function updateTodo(id: string, updates: TodoUpdate) {
  // 일부 필드만 업데이트 가능
}

// Pick - 특정 속성만 선택
type TodoMetadata = Pick<Todo, "id" | "title" | "priority">;

// Omit - 특정 속성 제외
type CreateTodoRequest = Omit<Todo, "id" | "createdAt">;

// Record - 객체 타입 생성
type TodoStatus = "pending" | "in-progress" | "completed";
type StatusColors = Record<TodoStatus, string>;
const colors: StatusColors = {
  "pending": "#yellow",
  "in-progress": "#blue",
  "completed": "#green"
};

// Required - 모든 속성 필수로
type RequiredTodo = Required<Todo>;

// Readonly - 모든 속성 읽기 전용
type ImmutableTodo = Readonly<Todo>;

커스텀 유틸리티 타입

// 깊은 부분 업데이트
type DeepPartial<T> = {
  [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
};

// 함수에서 Promise 타입 추출
type Awaited<T> = T extends Promise<infer U> ? U : T;

// 객체의 값 타입들만 추출
type ValueOf<T> = T[keyof T];

// 실무 예시: 폼 에러 타입
type FormErrors<T> = {
  [K in keyof T]?: string;
};

interface LoginForm {
  email: string;
  password: string;
}

const errors: FormErrors<LoginForm> = {
  email: "이메일이 유효하지 않습니다",
  password: "비밀번호는 최소 8자 이상이어야 합니다"
};

고급 타입 패턴

조건부 타입

// 기본 조건부 타입
type IsString<T> = T extends string ? true : false;
type Test1 = IsString<string>; // true
type Test2 = IsString<number>; // false

// infer로 타입 추론
type ReturnType<T> = T extends (...args: any[]) => infer R ? R : any;
type FunctionReturn = ReturnType<() => string>; // string

// 실무 예시: API 응답 타입 추출
type ExtractApiData<T> = T extends ApiResponse<infer U> ? U : never;
type UserData = ExtractApiData<ApiResponse<User>>; // User

// 배열 요소 타입 추출
type ArrayElement<T> = T extends (infer U)[] ? U : never;
type StringElement = ArrayElement<string[]>; // string

맵드 타입

// 기본 맵드 타입
type Optional<T> = {
  [P in keyof T]?: T[P];
};

// 수정자 활용
type Mutable<T> = {
  -readonly [P in keyof T]: T[P];
};

type Required<T> = {
  [P in keyof T]-?: T[P];
};

// 실무 예시: 폼 검증 스키마 생성
type ValidationSchema<T> = {
  [K in keyof T]: {
    required?: boolean;
    validator?: (value: T[K]) => boolean;
    message?: string;
  };
};

const userSchema: ValidationSchema<User> = {
  name: {
    required: true,
    validator: (value) => value.length > 0,
    message: "이름은 필수입니다"
  },
  email: {
    validator: (value) => value?.includes("@") || false,
    message: "올바른 이메일 형식이 아닙니다"
  }
};

템플릿 리터럴 타입 (2025년 활용도 증가)

// CSS 속성 자동완성
type Direction = "top" | "right" | "bottom" | "left";
type Margin = `margin-${Direction}`;
// "margin-top" | "margin-right" | "margin-bottom" | "margin-left"

// API 엔드포인트 타입 안전성
type HttpMethod = "GET" | "POST" | "PUT" | "DELETE";
type ApiEndpoint = `/api/${string}`;
type ApiCall = `${HttpMethod} ${ApiEndpoint}`;

// 실무 예시: 이벤트 이름 생성
type EventName<T extends string> = `on${Capitalize<T>}`;
type ButtonEvents = EventName<"click" | "hover" | "focus">;
// "onClick" | "onHover" | "onFocus"

// 경로 파라미터 추출
type ExtractPathParams<T extends string> =
  T extends `${string}:${infer Param}/${infer Rest}`
    ? Param | ExtractPathParams<Rest>
    : T extends `${string}:${infer Param}`
    ? Param
    : never;

type UserPath = "/users/:id/posts/:postId";
type Params = ExtractPathParams<UserPath>; // "id" | "postId"

⚛️ React와 함께 사용하기

컴포넌트 타입 정의

import React, { useState, useEffect, ReactNode } from 'react';

// Props 인터페이스
interface ButtonProps {
  variant: "primary" | "secondary" | "danger";
  size?: "sm" | "md" | "lg";
  disabled?: boolean;
  children: ReactNode;
  onClick?: (event: React.MouseEvent<HTMLButtonElement>) => void;
}

// 함수형 컴포넌트
const Button: React.FC<ButtonProps> = ({
  variant,
  size = "md",
  disabled = false,
  children,
  onClick
}) => {
  return (
    <button
      className={`btn btn-${variant} btn-${size}`}
      disabled={disabled}
      onClick={onClick}
    >
      {children}
    </button>
  );
};

// 제네릭 컴포넌트
interface DropdownProps<T> {
  items: T[];
  value?: T;
  onChange: (item: T) => void;
  renderItem: (item: T) => ReactNode;
  getKey: (item: T) => string;
}

function Dropdown<T>({ items, value, onChange, renderItem, getKey }: DropdownProps<T>) {
  return (
    <div className="dropdown">
      {items.map(item => (
        <div
          key={getKey(item)}
          onClick={() => onChange(item)}
          className={value === item ? "selected" : ""}
        >
          {renderItem(item)}
        </div>
      ))}
    </div>
  );
}

훅 타입 정의

// useState 타입 추론 활용
const [count, setCount] = useState(0); // number로 추론
const [user, setUser] = useState<User | null>(null); // 명시적 타입

// useEffect 의존성 배열 타입 안전성
useEffect(() => {
  fetchUserData(user?.id);
}, [user?.id]); // user가 변경될 때만 실행

// 커스텀 훅 타입 정의
interface UseApiResult<T> {
  data: T | null;
  loading: boolean;
  error: string | null;
  refetch: () => void;
}

function useApi<T>(url: string): UseApiResult<T> {
  const [data, setData] = useState<T | null>(null);
  const [loading, setLoading] = useState(true);
  const [error, setError] = useState<string | null>(null);

  const fetchData = async () => {
    try {
      setLoading(true);
      const response = await fetch(url);
      const result = await response.json();
      setData(result);
    } catch (err) {
      setError(err instanceof Error ? err.message : 'Unknown error');
    } finally {
      setLoading(false);
    }
  };

  useEffect(() => {
    fetchData();
  }, [url]);

  return {
    data,
    loading,
    error,
    refetch: fetchData
  };
}

// 사용 예시
const UserProfile: React.FC<{ userId: string }> = ({ userId }) => {
  const { data: user, loading, error } = useApi<User>(`/api/users/${userId}`);

  if (loading) return <div>Loading...</div>;
  if (error) return <div>Error: {error}</div>;
  if (!user) return <div>User not found</div>;

  return <div>Welcome, {user.name}!</div>;
};

이벤트 핸들링

// 일반적인 이벤트 타입들
type ClickHandler = (event: React.MouseEvent<HTMLButtonElement>) => void;
type ChangeHandler = (event: React.ChangeEvent<HTMLInputElement>) => void;
type SubmitHandler = (event: React.FormEvent<HTMLFormElement>) => void;

// 폼 컴포넌트 예시
interface FormData {
  email: string;
  password: string;
}

const LoginForm: React.FC = () => {
  const [formData, setFormData] = useState<FormData>({
    email: '',
    password: ''
  });

  const handleInputChange: ChangeHandler = (event) => {
    const { name, value } = event.target;
    setFormData(prev => ({
      ...prev,
      [name]: value
    }));
  };

  const handleSubmit: SubmitHandler = (event) => {
    event.preventDefault();
    // 폼 제출 로직
  };

  return (
    <form onSubmit={handleSubmit}>
      <input
        type="email"
        name="email"
        value={formData.email}
        onChange={handleInputChange}
      />
      <input
        type="password"
        name="password"
        value={formData.password}
        onChange={handleInputChange}
      />
      <button type="submit">Login</button>
    </form>
  );
};

실무 베스트 프랙티스

1. 타입 네이밍 컨벤션

// 좋은 네이밍
interface User {} // 파스칼 케이스
type ApiStatus = "loading" | "success" | "error"; // 파스칼 케이스
type UserRole = "admin" | "user"; // 의미있는 이름

// 제네릭 타입 매개변수
// T - Type, U - Another Type, K - Key, V - Value, P - Property
function transform<TInput, TOutput>(input: TInput): TOutput {
  // ...
}

// Props와 State 접미사 사용
interface ButtonProps {} // 컴포넌트 Props
interface AppState {} // 상태 타입

2. 타입 구성 전략

// 타입 파일 구조 (types/index.ts)
export interface User {
  id: string;
  name: string;
  email: string;
}

export interface ApiResponse<T> {
  data: T;
  status: number;
  message: string;
}

export type UserResponse = ApiResponse<User>;
export type UsersResponse = ApiResponse<User[]>;

// 도메인별 타입 분리
// types/user.ts
// types/product.ts
// types/api.ts

3. 에러 처리 패턴

// Result 패턴
type Result<T, E = Error> =
  | { success: true; data: T }
  | { success: false; error: E };

async function safeApiCall<T>(url: string): Promise<Result<T>> {
  try {
    const response = await fetch(url);
    const data = await response.json();
    return { success: true, data };
  } catch (error) {
    return {
      success: false,
      error: error instanceof Error ? error : new Error('Unknown error')
    };
  }
}

// 사용
const result = await safeApiCall<User>('/api/user');
if (result.success) {
  console.log(result.data.name); // 타입 안전
} else {
  console.error(result.error.message);
}

4. 환경 변수와 설정

// env.ts
interface Environment {
  API_URL: string;
  DEBUG: boolean;
  VERSION: string;
}

declare global {
  namespace NodeJS {
    interface ProcessEnv extends Environment {}
  }
}

// 타입 안전한 환경 변수 접근
export const config = {
  apiUrl: process.env.API_URL || 'http://localhost:3000',
  debug: process.env.DEBUG === 'true',
  version: process.env.VERSION || '1.0.0'
};

5. 상태 관리 타이핑

// Redux Toolkit과 함께
interface UserState {
  currentUser: User | null;
  loading: boolean;
  error: string | null;
}

interface AppState {
  user: UserState;
  posts: PostState;
  ui: UIState;
}

// Zustand와 함께
interface UserStore {
  user: User | null;
  setUser: (user: User) => void;
  clearUser: () => void;
  isLoggedIn: () => boolean;
}

const useUserStore = create<UserStore>((set, get) => ({
  user: null,
  setUser: (user) => set({ user }),
  clearUser: () => set({ user: null }),
  isLoggedIn: () => get().user !== null
}));

2025년 최신 기능

1. Native TypeScript Compiler (TypeScript 7.0 예정)

// 10배 빠른 컴파일 속도
// 50% 적은 메모리 사용량
// 8배 빠른 에디터 로딩

// 사용법은 동일하지만 성능이 크게 향상
npm install typescript@next

2. 향상된 타입 추론

// 더 정확한 제네릭 추론
function createArray<T>(items: T[]) {
  return items;
}

// 이제 더 정확하게 추론됨
const mixedArray = createArray([1, "hello", true]);
// (string | number | boolean)[]

3. 새로운 유틸리티 타입

// Satisfies 연산자로 더 나은 타입 체크
const config = {
  apiUrl: "https://api.example.com",
  timeout: 5000,
  retries: 3
} satisfies Config;

// Using import defer (ES2025)
import defer * as utils from './utils';
// 모듈을 지연 로딩하여 성능 향상

4. 개선된 에러 메시지

// 2025년 버전에서는 더 친화적인 에러 메시지
interface User {
  name: string;
  age: number;
}

const user: User = {
  name: "John"
  // Error: Property 'age' is missing in type
  //   Suggestion: Add 'age: number' to fix this error
};

⚡ 퀵 레퍼런스

자주 사용하는 패턴들

// 1. Optional Chaining과 Nullish Coalescing
const userName = user?.profile?.name ?? "Unknown";

// 2. Assertion Functions
function assertIsNumber(value: any): asserts value is number {
  if (typeof value !== "number") {
    throw new Error("Value must be number");
  }
}

// 3. Branded Types (더 엄격한 타입)
type UserId = string & { __brand: "UserId" };
type ProductId = string & { __brand: "ProductId" };

function createUserId(id: string): UserId {
  return id as UserId;
}

// 4. 함수 오버로딩
function createElement(tag: "button"): HTMLButtonElement;
function createElement(tag: "div"): HTMLDivElement;
function createElement(tag: string): HTMLElement;
function createElement(tag: string): HTMLElement {
  return document.createElement(tag);
}

// 5. 조건부 속성
interface BaseConfig {
  mode: "development" | "production";
}

interface DevelopmentConfig extends BaseConfig {
  mode: "development";
  debugTools: boolean;
}

interface ProductionConfig extends BaseConfig {
  mode: "production";
  optimizations: string[];
}

type Config = DevelopmentConfig | ProductionConfig;

디버깅과 개발 도구

// 타입 확인용 유틸리티
type Debug<T> = { [K in keyof T]: T[K] };
type Expand<T> = T extends infer O ? { [K in keyof O]: O[K] } : never;

// 컴파일 타임에 타입 테스트
type Assert<T extends true> = T;
type Test1 = Assert<true>; // ✅
// type Test2 = Assert<false>; // ❌ 컴파일 에러

// 런타임 타입 체크 (개발 환경)
const isDev = process.env.NODE_ENV === "development";
function devAssert(condition: any, message: string): asserts condition {
  if (isDev && !condition) {
    throw new Error(message);
  }
}

추가 학습 리소스

공식 문서와 도구

TypeScript 공식 문서
TypeScript Playground - 온라인 테스트
DefinitelyTyped - 타입 정의 라이브러리

실무에서 자주 설치하는 타입 패키지

# React 관련
npm install @types/react @types/react-dom

# Node.js 관련
npm install @types/node

# 유틸리티 라이브러리
npm install @types/lodash @types/uuid

# 테스팅
npm install @types/jest @types/testing-library__react

성능 최적화 팁

# 컴파일 속도 향상
npx tsc --incremental  # 증분 컴파일
npx tsc --watch        # 파일 변경 감시

# 타입 체크만 (JS 생성 안함)
npx tsc --noEmit

# 프로젝트 레퍼런스 사용 (큰 프로젝트)
# tsconfig.json에 references 설정

이 가이드는 실무에서 바로 사용할 수 있는 TypeScript 핵심 패턴들을 담았습니다. 처음에는 기본 타입부터 시작해서 점진적으로 고급 기능을 도입하는 것을 추천합니다.

정기적으로 업데이트되는 이 문서를 북마크하여 TypeScript 개발 시 참고하세요!

React Native에서 Cheerio 사용하기: TypeScript 타입 선언 완벽 가이드

thewavelet — Sun, 21 Sep 2025 12:02:38 +0900

React Native에서 Cheerio 사용하기: TypeScript 타입 선언 완벽 가이드

React Native 프로젝트에서 HTML 파싱을 위해 react-native-cheerio를 사용하다 보면, TypeScript 컴파일 오류가 발생하는 경우가 있습니다. 이는 해당 패키지에 타입 선언이 없기 때문인데, 이 문제를 해결하는 방법을 상세히 알아보겠습니다.

문제 상황

react-native-cheerio 패키지는 JavaScript로만 작성되어 있어서:

TypeScript 타입 선언이 없음
@types/react-native-cheerio도 존재하지 않음
따라서 TypeScript에서 사용 시 컴파일 오류 발생

해결 방법: 직접 타입 선언 파일 생성

1. 타입 선언 파일 생성

프로젝트 루트에 types/react-native-cheerio.d.ts 파일을 생성합니다.

declare module 'react-native-cheerio' {
  // Cheerio 요소의 기본 인터페이스
  interface CheerioElement {
    [key: string]: any;
  }

  // Cheerio 인스턴스 (jQuery 스타일 API)
  interface CheerioInstance {
    // 선택자 메서드
    find(selector: string): CheerioInstance;

    // 텍스트 조작
    text(): string;
    text(text: string): CheerioInstance;

    // HTML 조작
    html(): string;
    html(html: string): CheerioInstance;

    // 속성 조작
    attr(name: string): string;
    attr(name: string, value: string): CheerioInstance;

    // 반복 처리
    each(fn: (index: number, element: CheerioElement) => void): CheerioInstance;

    // 배열 스타일 접근
    length: number;
    [index: number]: CheerioElement;
  }

  // Cheerio 메인 인터페이스
  interface CheerioStatic {
    // 메인 함수 호출 시그니처
    (selector?: any, context?: any, root?: any, options?: any): CheerioInstance;

    // HTML 파싱 메서드
    load(html: string, options?: any): CheerioInstance;

    // 버전 정보
    version: string;
  }

  const reactNativeCheerio: CheerioStatic;
  export default reactNativeCheerio;
}

2. tsconfig.json 설정

tsconfig.json에서 타입 선언 파일을 인식하도록 설정합니다:

{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./types"]
  },
  "include": [
    "types/**/*"
  ]
}

사용 방법

타입 선언 파일을 생성한 후, 다음과 같이 사용할 수 있습니다:

import cheerio from 'react-native-cheerio';

const htmlString = '<div><p>Hello World</p></div>';
const $ = cheerio.load(htmlString);

// 텍스트 추출
const text = $('p').text(); // "Hello World"

// HTML 조작
$('p').html('<strong>Bold Text</strong>');

// 속성 조작
$('div').attr('class', 'container');

// 반복 처리
$('p').each((index, element) => {
  console.log(`Element ${index}:`, element);
});

Import 스타일 선택

권장: Default Import

import cheerio from 'react-native-cheerio';

대안: Namespace Import

import * as cheerio from 'react-native-cheerio';

Default Import를 권장하는 이유:

더 명확한 의미: "하나의 주요 기능을 가져온다"
현대적 ES Module 스타일
혼란 방지: Named exports와 구분됨

TypeScript 타입 선언 우선순위

TypeScript는 다음 순서로 타입 선언을 찾습니다:

node_modules/@types/react-native-cheerio (DefinitelyTyped)
react-native-cheerio/package.json의 "types" 필드
react-native-cheerio/index.d.ts (패키지 루트)
프로젝트 내 타입 선언 파일 ← 우리가 만든 파일
없으면 'any' 타입으로 추론

프로젝트 구조 권장사항

your-project/
├── types/           # 외부 패키지 타입 선언
│   └── react-native-cheerio.d.ts
├── typings/         # 프로젝트 내부 커스텀 타입
│   └── custom.ts
└── src/
    └── ...

마무리

이제 React Native 프로젝트에서 TypeScript의 타입 안정성을 유지하면서 Cheerio를 사용할 수 있습니다. 타입 선언 파일을 통해 IDE의 자동완성과 타입 체크 기능도 정상적으로 작동합니다.

필요에 따라 더 많은 Cheerio 메서드를 타입 선언에 추가할 수 있으며, 이는 프로젝트의 요구사항에 맞춰 점진적으로 확장 가능합니다.

참고: src/types/react-native-cheerio.d.ts 전체 코드

/**
 * ================================================================
 * react-native-cheerio 모듈에 대한 TypeScript 타입 선언 파일
 * ================================================================
 *
 *   목적: TypeScript 컴파일 오류 해결
 * - react-native-cheerio 패키지는 JavaScript로만 작성됨 (타입 없음)
 * - @types/react-native-cheerio도 존재하지 않음
 * - 따라서 직접 타입 선언 파일을 생성하여 타입 안정성 확보
 *
 *   react-native-cheerio 패키지 분석:
 *
 *   실제 파일 구조:
 * - index.js: exports = module.exports = require('./lib/cheerio');
 * - lib/cheerio.js: var Cheerio = module.exports = function(selector, context, root, options) { ... }
 *
 *   CommonJS 패턴:
 * module.exports = function cheerio() { ... }
 * cheerio.load = function(html) { ... }  // 함수에 메서드 추가
 * cheerio.version = "1.0.0"              // 함수에 속성 추가
 *
 *   CommonJS vs ES Modules 호환성:
 *
 *   CommonJS (react-native-cheerio의 실제 방식):
 * - 내보내기: module.exports = function
 * - 특징: 하나의 객체/함수를 내보냄
 * - 런타임: 동기적 로딩
 *
 *   ES Modules (현대적 방식):
 * - Named exports: export const func1 = ..., export const func2 = ...
 * - Default export: export default function
 * - 특징: 정적 분석 가능, 트리 쉐이킹 지원
 *
 *   TypeScript/Babel의 호환성 마법:
 *
 * CommonJS 패키지를 ES Module 스타일로 import 가능:
 * - import * as cheerio from 'pkg' → const cheerio = require('pkg')
 * - import cheerio from 'pkg' → const cheerio = require('pkg')
 * - 결과: 둘 다 동일한 함수를 가져옴!
 *
 *   왜 이런 호환성이 필요한가?
 * 1. 역사적 이유: CommonJS가 먼저 존재
 * 2. 점진적 마이그레이션: 기존 패키지들의 ES Module 전환 지원
 * 3. 개발자 편의: 원하는 import 스타일 선택 가능
 *
 *   import 스타일 선택 기준:
 *
 * ❌ 기존 방식: import * as cheerio from 'react-native-cheerio'
 * - CommonJS라서 이렇게 써야 한다는 고정관념
 * - 실제로는 둘 다 동작함
 *
 * ✅ 권장 방식: import cheerio from 'react-native-cheerio'
 * - 논리적으로 더 명확: "하나의 주요 기능을 가져온다"
 * - Named exports와 헷갈리지 않음
 * - 현대적 ES Module 스타일
 *
 *   import 스타일 비교:
 *
 * Named exports 패키지 (여러 기능):
 * export const func1 = ...
 * export const func2 = ...
 * → import { func1, func2 } from 'pkg' (선택적)
 * → import * as all from 'pkg' (전체를 namespace로)
 *
 * CommonJS 패키지 (하나의 주요 기능):
 * module.exports = function
 * → import cheerio from 'pkg' (권장)
 * → import * as cheerio from 'pkg' (가능하지만 혼란 야기)
 *
 *  ️ 타입 선언 방식 선택:
 *
 * 옵션 1: export = (CommonJS 스타일)
 * declare module 'react-native-cheerio' {
 *   interface CheerioStatic { ... }
 *   const cheerio: CheerioStatic;
 *   export = cheerio;  // TypeScript 전용 문법
 * }
 * 사용: import * as cheerio from 'react-native-cheerio'
 *
 * 옵션 2: export default (ES Module 스타일) ← 현재 선택
 * declare module 'react-native-cheerio' {
 *   interface CheerioStatic { ... }
 *   const cheerio: CheerioStatic;
 *   export default cheerio;  // 표준 ES Module 문법
 * }
 * 사용: import cheerio from 'react-native-cheerio'
 *
 *   현재 선택한 이유:
 * 1. 논리적 명확성: 하나의 주요 기능 → default import
 * 2. 현대적 스타일: ES Module 표준 문법 사용
 * 3. 혼란 방지: Named exports와 구분되는 명확한 패턴
 * 4. 사용자 편의: cheerio.load() 직관적 사용
 *
 *   TypeScript 타입 선언 파일 참조 우선순위:
 * 1️⃣ node_modules/@types/react-native-cheerio (DefinitelyTyped) - ❌ 없음
 * 2️⃣ react-native-cheerio/package.json의 "types" 필드 - ❌ 없음
 * 3️⃣ react-native-cheerio/index.d.ts (패키지 루트) - ❌ 없음
 * 4️⃣ 프로젝트 내 타입 선언 파일 (이 파일!) - ✅ 여기서 발견!
 * 5️⃣ 없으면 'any' 타입으로 추론
 *
 *   타입 선언 충돌과 Module Augmentation:
 *
 *   우선순위에 의한 덮어쓰기:
 * - 높은 우선순위가 낮은 우선순위를 완전히 덮어씀 (병합 안됨!)
 * - 예: @types/react + 프로젝트/react.d.ts → @types/react만 사용
 *
 *   Module Augmentation (모듈 확장):
 * - 기존 타입에 새로운 속성/메서드 추가
 * - 핵심 요구사항: 파일에 import/export 문이 있어야 함!
 *
 * 예시:
 * // react-augmentation.d.ts
 * import React from 'react';  // 이것이 augmentation 모드로 전환!
 *
 * declare module 'react' {
 *   interface HTMLAttributes<T> {
 *     customProp?: string;  // 기존 interface에 속성 추가
 *   }
 * }
 *
 *   Declaration vs Augmentation 모드:
 * - Declaration 모드 (import/export 없음): 새로운 모듈 선언 → 우선순위 적용
 * - Augmentation 모드 (import/export 있음): 기존 모듈 확장 → 병합
 *
 *   타입 선언 우선순위 시스템 상세:
 *
 *   모듈별 개별 우선순위 (declare module 기준):
 * TypeScript는 각 모듈명에 대해 개별적으로 우선순위를 적용합니다.
 *
 * 예시 상황:
 * // @types/lodash/index.d.ts
 * declare module 'lodash' { export function map(): any; }
 * declare module 'lodash/map' { export default function(): any; }
 *
 * // lodash/index.d.ts (패키지 자체)
 * declare module 'lodash' { export function filter(): any; }
 * declare module 'lodash/debounce' { export default function(): any; }
 *
 *   우선순위 적용 결과:
 * - 'lodash' 모듈: @types/lodash 버전 사용 (패키지 버전 무시)
 * - 'lodash/map' 모듈: @types/lodash 버전 사용
 * - 'lodash/debounce' 모듈: lodash 패키지 버전 사용 (@types에 없으므로)
 *
 * ⚠️ 전역 선언의 충돌 (declare const/function/class/var):
 * 모듈 우선순위와 달리 전역 선언은 충돌 시 컴파일 에러 발생!
 *
 * 충돌 예시:
 * // @types/jquery/index.d.ts
 * declare const $: JQueryStatic;
 *
 * // 사용자의 types/jquery.d.ts
 * declare const $: MyCustomType;  // ❌ 컴파일 에러!
 * // Error: Duplicate identifier '$'
 *
 *  ️ 전역 충돌 방지 방법:
 * 1. ES Module 사용: export {} 추가하여 파일을 모듈로 만들기
 * 2. skipLibCheck: true 설정 (tsconfig.json)
 * 3. 전역 이름 피하기: Node, Array, String 등 내장 객체명 사용 금지
 * 4. 적절한 타입 정의 설치: @types/node 등
 *
 *   2025년 TypeScript 프로젝트 구조 베스트 프랙티스:
 *
 *   현재 프로젝트 구조 평가:
 * ✅ types/ - 외부 패키지 타입 선언 (.d.ts 파일들)
 * ✅ typings/ - 프로젝트 내부 커스텀 타입들 (.ts 파일들)
 * → 업계 표준과 완벽히 일치하는 구조!  
 *
 *   결론:
 * - react-native-cheerio는 CommonJS 방식의 단일 함수 패키지
 * - export default로 타입 선언하여 import cheerio 스타일 사용
 * - 논리적으로 명확하고 현대적인 ES Module 패턴 적용
 * - TypeScript 컴파일 오류 해결과 동시에 타입 안정성 확보
 */

//   TypeScript 타입 선언 키워드들:
//
//   declare의 의미:
// - "어딘가에 이미 존재한다"고 TypeScript에게 알려주는 키워드
// - 실제 구현 없이 타입 정보만 선언
// - 컴파일 시점에만 존재, JavaScript로 변환되면 사라짐
//
//   declare 사용 예시들:
// declare const globalVar: string;        // 전역 변수 타입 선언
// declare function globalFunc(): void;    // 전역 함수 타입 선언
// declare class GlobalClass { ... }       // 전역 클래스 타입 선언
// declare var window: Window;             // 브라우저 전역 객체
//
//   module의 의미:
// - 모듈(패키지)의 네임스페이스를 정의
// - 특정 모듈명에 대한 타입 정보를 그룹화
// - import/export와 연결되는 실제 모듈 시스템
//
//   declare module 조합:
// - "이 모듈명으로 import할 때 어떤 타입을 사용할지" 알려주는 선언
// - 실제 패키지 코드와는 무관하게 타입 정보만 제공함
//
//   namespace의 의미:
// - 관련된 타입들을 그룹화하는 TypeScript 개념
// - 전역 스코프 오염을 방지하고 코드를 구조화
// - 점(.) 표기법으로 접근: MyNamespace.SomeType
// - 컴파일 시점에만 존재 (런타임에서 사라짐)
//
//   namespace 예시:
// declare namespace jQuery {
//   interface JQueryStatic {
//     (selector: string): JQuery;
//     ajax(settings: any): void;
//   }
//   interface JQuery {
//     click(): JQuery;
//     hide(): JQuery;
//   }
// }
// 사용: const $: jQuery.JQueryStatic = ...;
//      const element: jQuery.JQuery = ...;
//
//   핵심 차이점:
//
//   객체 (런타임에 실제 존재):
// const Utils = {
//   formatDate: (date: Date) => date.toString(),
//   API_URL: 'https://api.com'
// };
// Utils.formatDate(new Date());  // 실행 가능! 실제 함수 호출
//
//   namespace (컴파일 시점에만 존재):
// namespace Utils {
//   export type DateFormat = 'ISO' | 'US';
//   export interface ApiResponse { data: any }
// }
// const format: Utils.DateFormat = 'ISO';  // 타입으로만 사용
// Utils.formatDate(new Date());  // ❌ 에러! 런타임에 존재하지 않음
//
//   module vs namespace 차이:
// - module: 실제 파일/패키지와 연결 (import/export 시스템)
// - namespace: 타입들의 논리적 그룹핑 (점 표기법 접근, 타입 전용)
//
//  ️ 과거 vs 현재:
// - 과거: namespace를 많이 사용 (TypeScript 초기)
// - 현재: ES Modules이 표준이 되면서 declare module을 더 선호
// - namespace는 여전히 타입 그룹화에 유용

declare module 'react-native-cheerio' {
  // Cheerio 요소의 기본 인터페이스
  interface CheerioElement {
    [key: string]: any;
  }

  // Cheerio 인스턴스 (jQuery 스타일 API)
  interface CheerioInstance {
    // 선택자 메서드
    find(selector: string): CheerioInstance;

    // 텍스트 조작
    text(): string;
    text(text: string): CheerioInstance;

    // HTML 조작
    html(): string;
    html(html: string): CheerioInstance;

    // 속성 조작
    attr(name: string): string;
    attr(name: string, value: string): CheerioInstance;

    // 반복 처리
    each(fn: (index: number, element: CheerioElement) => void): CheerioInstance;

    // 배열 스타일 접근
    length: number;
    [index: number]: CheerioElement;

    // 필요시 더 많은 jQuery 스타일 메서드 추가 가능
    // addClass, removeClass, hasClass, css, etc.
  }

  // Cheerio 메인 인터페이스 (함수이면서 동시에 객체)
  interface CheerioStatic {
    // 메인 함수 호출 시그니처 (cheerio('selector') 형태)
    (selector?: any, context?: any, root?: any, options?: any): CheerioInstance;

    // load 메서드 - HTML 문자열을 파싱하여 Cheerio 인스턴스 반환
    load(html: string, options?: any): CheerioInstance;

    // version 속성 (package.json에서 export됨)
    version: string;
  }

  // react-native-cheerio를 default export로 선언
  // 사용법: import cheerio from 'react-native-cheerio'
  const reactNativeCheerio: CheerioStatic;
  export default reactNativeCheerio;
}

안드로이드에서는 실제 배포된 앱이 아니면 결제가 실제로 이루어지지 않습니다.

thewavelet — Thu, 18 Sep 2025 00:45:00 +0900

안드로이드에서는 실제 배포된 앱이 아니면 결제가 실제로 이루어지지 않습니다.

   안드로이드 IAP 테스트 환경

  개발/디버그 모드에서는:

  - ✅ 결제 UI는 표시됨
  - ✅ Google Play 결제 다이얼로그 나타남
  - ❌ 실제 결제는 처리되지 않음
  - ❌ 서버로 전송할 유효한 receipt 생성 안됨

  실제 결제가 되는 경우:

  1. Google Play Console에 APK 업로드
  2. Internal Testing 또는 Closed Testing 트랙에 배포
  3. 테스터 계정으로 Play Store에서 다운로드
  4. 그 앱에서 결제 시도

  테스트 방법:

  # 1. 릴리즈 빌드 생성
  npx react-native run-android --variant=release

  # 2. APK 생성
  cd android && ./gradlew assembleRelease

  # 3. Google Play Console에 업로드
  # 4. Internal Testing 트랙에 배포
  # 5. 테스터 계정으로 다운로드하여 테스트

   현재 상황 분석

  지금까지의 문제들은 모두 개발 환경의 한계였을 가능성이 높습니다:
  - 로딩 인디케이터가 사라지지 않음 → 유효한 receipt가 없어서 서버 처리 실패
  - "이미 보유한 아이템" → Google Play에서 가짜 구매 상태 유지
  - 서버 요청 안됨 → receipt 데이터가 유효하지 않음

  실제 배포된 앱에서 테스트해야 정확한 결제 플로우를 확인할 수 있습니다.

  iOS는 Simulator/TestFlight 환경에서도 테스트가 가능하지만, 안드로이드는 반드시 Play Store를 통해 배포된
  앱에서만 실제 결제가 작동합니다.

directly 'pod install' deprecated, rosetta2, intell x86 vs arm64

thewavelet — Wed, 17 Sep 2025 20:46:12 +0900

==================== DEPRECATION NOTICE =====================
Calling `pod install` directly is deprecated in React Native
because we are moving away from Cocoapods toward alternative
solutions to build the project.
* If you are using Expo, please run:
`npx expo run:ios`
* If you are using the Community CLI, please run:
`yarn ios`
=============================================================

[!] Do not use "pod install" from inside Rosetta2 (x86_64 emulation on arm64).

[!] - Emulated x86_64 is slower than native arm64

[!] - May result in mixed architectures in rubygems (eg: ffi_c.bundle files may be x86_64 with an arm64 interpreter)

[!] Run "env /usr/bin/arch -arm64 /bin/bash --login" then try again.

[!] RNNotifee: using Notification Service Extension.

[!] hermes-engine has added 1 script phase. Please inspect before executing a build. See `https://guides.cocoapods.org/syntax/podspec.html#script_phases` for more information.

⏺ 1. pod install 가 Rosetta2에서 실행되는 이유

  M2 맥북인데도 Rosetta2 경고가 나오는 이유는 터미널이나 Ruby가 x86_64 모드로 실행되고 있기 때문입니다.
  마이그레이션으로 옮겨온 경우 다음이 원인일 수 있습니다:

  - 터미널 앱 자체가 Rosetta 모드로 설정됨
  - Ruby/rbenv/CocoaPods가 Intel 버전으로 설치됨
  - 환경변수나 PATH가 Intel 버전을 가리킴

⏺ 2. 아키텍처 혼용 문제

  Rosetta2에서 pod install을 실행하면:
  - 성능 저하: x86_64 에뮬레이션으로 느려짐
  - 아키텍처 혼용: ffi_c.bundle 같은 네이티브 라이브러리가 x86_64로 컴파일되는데 Ruby 인터프리터는 arm64일 수
  있음
  - 빌드 오류 가능성: 혼합된 아키텍처로 인한 예기치 못한 오류

⏺ 3. 해결 방법

  즉시 해결 (임시):

  env /usr/bin/arch -arm64 /bin/bash --login
  cd ios && pod install

  근본적 해결:

  1. 터미널 앱 확인:
  - Applications > Terminal > 우클릭 > Get Info
  - "Open using Rosetta" 체크 해제

  2. Ruby 재설치 (arm64 네이티브):
  # 현재 아키텍처 확인
  uname -m  # arm64여야 함
  which ruby
  ruby -e "puts RUBY_PLATFORM"

  # rbenv 사용 시
  rbenv uninstall [현재버전]
  rbenv install [최신버전]
  rbenv global [최신버전]

  # 또는 Homebrew로 Ruby 재설치
  brew uninstall ruby
  brew install ruby

  3. CocoaPods 재설치:
  gem uninstall cocoapods
  gem install cocoapods

⏺ 4. Deprecation Notice 대응

  React Native은 CocoaPods에서 다른 솔루션으로 전환 중입니다.

  권장 사용법:
  - Expo 사용 시: npx expo run:ios
  - Community CLI 사용 시: yarn ios

  현재 프로젝트에서는 yarn ios 명령어를 사용하는 것이 좋습니다.

  5. 추가 경고들

  - RNNotifee: Notification Service Extension 사용 중 (정상)
  - hermes-engine: 스크립트 단계 추가됨 (빌드 전 검토 권장)

⏺ 요약: 마이그레이션으로 인해 Intel 버전 Ruby/CocoaPods가 설치되어 있을 가능성이 높습니다. arm64 네이티브
  환경으로 재설치하고, 앞으로는 yarn ios 명령어를 사용하세요.

  React Native의 방향성:
  - 현재: CocoaPods 사용 중 (하지만 deprecated)
  - 미래: CocoaPods 없이 다른 솔루션으로 전환 예정

  현재 상황에서는:
  1. yarn ios가 내부적으로 pod install을 자동 실행합니다
  2. 하지만 여전히 CocoaPods 의존성이 필요합니다
  3. 에러 코드 65는 Xcode 빌드 실패를 의미합니다

  당분간은:
  - pod install 여전히 필요
  - yarn ios 사용 권장 (자동으로 pod install 실행)
  - 빌드 실패 시 pod install 수동 실행 필요할 수 있음

  완전히 CocoaPods 없어지는 시기:
  - React Native 0.82+ 이후 단계적으로
  - 아직 구체적인 일정은 미정

⏺ 결론: 지금은 여전히 CocoaPods가 필요하고, yarn ios 실패 시 pod install을 직접 실행해야 할 수도 있습니다.

1	피디팝	https://pdpop.com/	1600-8744
2	스마트파일	https://smartfile.co.kr/	1899-5771
3	파일캐스트	https://filecast.co.kr/	1600-0335
4	메가파일	https://www.megafile.co.kr/	1688-7587
5	파일시티	https://www.filecity.co.kr/	1666-2169
6	셰어박스	https://sharebox.co.kr/	1661-0872
7	온디스크	https://m.ondisk.co.kr/	1599-6221
8	파일조	https://www.filejo.com/	1588-2943
9	파일스타	https://filestar.co.kr/	1644-4743
10	~~지파일~~	~~https://www.gfile.co.kr/~~	1544-4811
11	파일몽	https://filemong.com/	1833-4725
12	애플파일	https://www.applefile.com/	1599-9054
13	파일이즈	https://fileis.com/	1544-9097
14	미투디스크	https://me2disk.com/	1544-8638
15	예스파일	https://www.yesfile.com/	1599-9052
16	파일마루	https://www.filemaru.com/	1522-0576
17	싸다파일	https://ssadafile.com/	1522-1557
18	투디스크	https://www.todisk.com/	1644-7879
19	꿀파일	https://ggulfile.com/	1555-1326
20	파일썬	https://www.filesun.com/	1600-6093
21	지니파일	https://geniefile.com/	1551-5772
22	파일보고	https://www.filebogo.com/	1800-4505
23	티플	https://www.tple.co.kr/	1688-8474

thewavelet

React Native 0.83 and Expo 55

Expo SDK 55 릴리즈 노트

전환 기간 안내 (Expo Go)

기본 프로젝트 템플릿 개편

새 템플릿으로 프로젝트 생성하기

레거시 아키텍처 지원 종료

Hermes v1 옵트인 지원

Hermes 바이트코드 Diff 업데이트 (EAS Update)

Expo 개발자를 위한 AI 도구 확장

MCP: CLI 액션 및 EAS 서비스 연동

Agent Skills

"Brownfield" — 기존 네이티브 앱에 Expo 추가

Expo Router 네이티브 기능 강화

Expo UI (2026년 중반 안정화 목표)

Jetpack Compose Beta

SwiftUI Beta

새로운 Expo SDK 패키지 버전 체계

Expo Modules Core

Expo CLI 개선 사항

expo-widgets iOS 알파 릴리즈

expo-blur Android 안정화

expo-sharing — 공유 데이터 수신 기능 (실험적)

기타 주요 업데이트

Deprecations (지원 중단 예정)

주요 Breaking Changes

도구 버전 변경

SDK 55 업그레이드 가이드

한의원 추나요법, 건강보험에 실비까지 된다고요? 직접 받아보고 비용 다 정리했습니다

추나요법, 건강보험 급여 됩니다

추나요법 종류별 가격 (2026년 기준)

연간 20회 급여 – 이게 핵심 포인트예요

20회 다 쓰고 나서도 계속 받을 수 있어요

여기서부터가 진짜 핵심 – 실비보험까지 됩니다

실비 적용 구조 – 이게 진짜 포인트예요

실비보험 세대별로 보장이 달라요 – 꼭 확인하세요

실비보험 청구 방법 – 어렵지 않아요

준비 서류

청구 방법

청구 기한

실비 청구 때 이것만 주의하세요

이런 분들이라면 지금 바로 알아보세요

정리하면 이렇습니다

임플란트 비용 얼마가 적당할까? 2026년 최신 가격 총정리 (보험 적용·덤핑 주의까지)

임플란트, 도대체 얼마가 '정상 가격'일까?

2026년 임플란트 가격 — 재료별 정리

왜 치과마다 가격이 이렇게 다를까? — 5가지 이유

1. 임플란트 브랜드 (국산 vs 수입)

2. 크라운 재료

3. 뼈이식·추가 수술 여부

4. 병원 위치와 규모

5. 의사의 경력과 사후관리

65세 이상이라면 꼭 알아야 할 — 건강보험 적용 제도

조건 요약

실제 본인부담금은?

주의사항 — 이것만큼은 꼭 확인하자

"임플란트 69만 원" 광고, 믿어도 될까? — 덤핑 치과 구별법

임플란트 시술 과정 — 얼마나 걸릴까?

임플란트 vs 브릿지 vs 틀니 — 비용과 장단점 비교

치과 선택 전 꼭 해야 할 3가지

마무리 — 가격보다 중요한 것

리니지 클래식 완벽 정리 — 2026년 2월 출시, 월정액·직업·논란까지 한 번에

"린저씨들, 집결"… 아덴 대륙이 2026년에 다시 열렸다

리니지 클래식이란?

요금제 — 월정액 29,700원, 이게 얼마나 의미 있는 숫자냐면

4대 직업 완벽 정리 — 군·기·요·마

군주 — 혈맹을 이끄는 지도자

기사 — 리니지를 대표하는 올라운더

요정 — 원거리 딜러 + 채집·제작

마법사 — 전장의 게임 체인저

핵심 콘텐츠 — 혈맹과 공성전

출시 성적 — 숫자로 보는 반응

논란도 솔직하게 — 알고 들어가자

이런 분들에게 추천

한 줄 요약

스픽(Speak) 앱 솔직 후기 — AI랑 영어로 실제로 말하는데 한 달에 만원대?

영어 공부 20년인데 왜 아직도 입이 안 떨어질까?

스픽(Speak)이란?

핵심 기능 4가지

1. 오늘의 수업 (Daily Lesson)