diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b71651a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,85 @@
+# IYKYKA (MSN) — 멀티 컨텍스트 메신저
+
+Flutter 클라이언트와 Node.js 서버로 구성된 메신저 예제 프로젝트입니다. **컨텍스트**(일상·업무 등)별로 공간을 나누고, 그 안에서 방·메시지·프로필을 사용합니다.
+
+---
+
+## 사전 요구 사항
+
+| 구분 | 내용 |
+|------|------|
+| 서버 | Node.js (npm) |
+| 모바일 | Flutter SDK |
+
+---
+
+## 서버 (REST + WebSocket)
+
+```bash
+cd server
+npm install
+npm run dev
+```
+
+| 항목 | 값 |
+|------|-----|
+| HTTP | `http://127.0.0.1:8787` |
+| WebSocket | `ws://127.0.0.1:8787/ws?token=JWT` |
+| 데이터베이스 | `server/data/msn.db` (SQLite, Node 내장 `node:sqlite`) |
+
+### 데모 계정 (최초 기동 시 시드)
+
+`alice@demo.msn`이 없으면 서버가 한 번만 데모 데이터를 넣습니다.
+
+| 이메일 | 비밀번호 | 비고 |
+|--------|----------|------|
+| `alice@demo.msn` | `demo1234` | **일상**·**데모 회사** 컨텍스트 보유. 업무 공간에서 샘플 DM 확인 가능 |
+| `bob@demo.msn` | `demo1234` | 멀티 기기·다른 사용자 테스트용 |
+
+**DB를 처음부터 다시 쓰려면** 서버를 끄고 `server/data/msn.db`를 삭제한 뒤 다시 실행합니다.
+
+---
+
+## 모바일 (Flutter)
+
+`mobile/`에서 실행합니다.
+
+```bash
+cd mobile
+flutter pub get
+flutter run --dart-define=API_BASE=http://127.0.0.1:8787
+```
+
+- **Android 에뮬레이터**에서 PC의 로컬 서버에 붙일 때:  
+  `--dart-define=API_BASE=http://10.0.2.2:8787`
+- **`android/` / `ios/` 폴더가 없다면** `mobile/` 안에서 한 번 `flutter create .` 로 생성합니다.
+
+### 웹 (`flutter run -d chrome`)
+
+`sqflite`가 웹에서 동작하지 않아 **채팅 로컬 캐시 전체**는 Android / Windows 데스크톱 / iOS 사용을 권장합니다.
+
+### Firebase / FCM
+
+푸시 알림·토큰 등록을 쓰려면 `flutterfire configure` 등으로 `firebase_options` 및 플랫폼 설정을 맞춰야 합니다. 미구성 시에도 앱은 기동할 수 있도록 처리되어 있습니다.
+
+---
+
+## 구현된 기능 요약
+
+- JWT 인증, 세션, 선택된 컨텍스트(메신저 공간) — 보안 저장소·설정 연동
+- 컨텍스트(일상·업무 등), 이메일 초대, `contextId` 기준 프로필 API
+- 1:1·그룹 방, WebSocket 메시지, 컨텍스트별 로컬 SQLite 메시지 캐시
+- 푸시 토큰 등록(FCM 연동 시 서버에 등록), 검색·읽음 처리(서버 확장), 앱 메뉴에서 그룹 방 생성
+- 설정(테마·알림), 검색 탭(메시지/방/친구), 전송 재시도 큐, 타이핑·1:1 읽음 표시(WebSocket) 등
+
+---
+
+## 빌드·검증 (참고)
+
+```bash
+# 모바일
+cd mobile && dart analyze lib && flutter test
+
+# 서버
+cd server && npx tsc --noEmit
+```