CodeBlueprint

GoF 23개 디자인 패턴과 73개 알고리즘을 빠르게 검색하고 참조할 수 있는 개발자 도구

CodeBlueprint는 Kotlin Multiplatform과 Compose Multiplatform을 기반으로 macOS, Android, iOS에서 동일한 코드베이스로 실행되는 소프트웨어 설계 패턴 참조 애플리케이션입니다.

스크린샷

macOS

디자인 패턴 목록 화면 - 생성 패턴 카테고리

주요 기능

디자인 패턴

23개 GoF 디자인 패턴 수록
- 생성 패턴 (5개): Singleton, Factory Method, Abstract Factory, Builder, Prototype
- 구조 패턴 (7개): Adapter, Bridge, Composite, Decorator, Facade, Flyweight, Proxy
- 행위 패턴 (11개): Chain of Responsibility, Command, Iterator, Mediator, Memento, Observer, State, Strategy, Template Method, Visitor, Interpreter
패턴별 상세 설명, 장단점, 활용 사례 제공
다국어 코드 예시: Kotlin, Java, Swift, Python, JavaScript

알고리즘

73개 핵심 알고리즘 수록 (9개 카테고리)
- 정렬 (13개), 탐색 (8개), 그래프 (12개), 동적 프로그래밍 (8개)
- 분할 정복 (5개), 탐욕 (5개), 백트래킹 (5개), 문자열 (7개), 수학 (10개)
시간/공간 복잡도 분석
구현 코드 및 활용 사례

아키텍처 패턴

5가지 아키텍처 패턴 수록
- MVC (Model-View-Controller)
- MVP (Model-View-Presenter)
- MVVM (Model-View-ViewModel)
- Clean Architecture
- MVI (Model-View-Intent)
계층별 역할 및 책임 설명
다이어그램 및 비교 분석 (복잡도, 테스트 용이성, 확장성 등)
Android 권장 여부 표시

코드 플레이그라운드

5개 언어 지원: Kotlin, Java, Python, JavaScript, Swift
코드 직접 편집 및 실행 시뮬레이션
문자열 템플릿 지원:
- Kotlin: $var, ${expr}
- Python: f-string {var}
- JavaScript: 템플릿 리터럴 `${var}`
- Swift: \(var)
- Java: 문자열 연결 +
실행 결과 및 실행 시간 표시

빠른 접근 및 검색

통합 검색: 패턴과 알고리즘을 동시에 검색, 탭 UI로 결과 구분
북마크: 자주 참조하는 패턴/알고리즘 저장
빠른 접근: 북마크된 항목을 목록 상단에 칩으로 표시
설정: 테마, 기본 코드 언어 설정

아키텍처

모듈 구조

graph TB
    subgraph "Platform Apps"
        A[desktopApp<br/>macOS]
        B[androidApp<br/>Android]
        C[iosApp<br/>iOS]
    end

    subgraph "Shared UI"
        D[composeApp<br/>Compose Multiplatform]
    end

    subgraph "Core Logic"
        E[shared<br/>Clean Architecture]
    end

    A --> D
    B --> D
    C --> D
    D --> E

Clean Architecture 레이어

graph LR
    UI["UI Layer<br/>(composeApp)"] --> Presentation["Presentation<br/>ViewModel, UiState"]
    Presentation --> Domain["Domain<br/>UseCase, Repository Interface"]
    Domain --> Data["Data<br/>Repository Impl, SQLDelight"]

데이터 흐름

sequenceDiagram
    participant UI as Screen
    participant VM as ViewModel
    participant UC as UseCase
    participant Repo as Repository
    participant DB as SQLDelight

    UI->>VM: 사용자 액션
    VM->>UC: 실행
    UC->>Repo: 데이터 요청
    Repo->>DB: 쿼리
    DB-->>Repo: 결과
    Repo-->>UC: 도메인 모델
    UC-->>VM: 결과
    VM-->>UI: UiState 업데이트

기술 스택

용도	라이브러리
언어	Kotlin 2.0, Kotlin Multiplatform
UI	Compose Multiplatform, Material 3
DI	Koin
Database	SQLDelight
Navigation	Decompose
Async	Kotlin Coroutines
Serialization	kotlinx.serialization

시작하기

요구사항

JDK 17 이상
Android SDK API 35 이상 (Android 빌드)
- local.properties에 SDK 경로 설정: sdk.dir=/path/to/Android/sdk
Xcode 15 이상 (iOS 빌드)

빌드 및 실행

# Desktop (macOS) 앱 실행
./gradlew desktopApp:run

# Android 앱 빌드
./gradlew androidApp:assembleDebug

# iOS 앱 (Xcode에서 열기)
open iosApp/iosApp.xcodeproj

# 전체 빌드
./gradlew build

배포 빌드

# 전체 빌드 + 결과물 수집 (권장)
./gradlew buildAndCollect

# 개별 빌드 후 수집
./gradlew desktopApp:createDistributable desktopApp:packageDmg androidApp:assembleDebug collectOutputs

# outputs 폴더 정리
./gradlew cleanOutputs

빌드 결과물은 build/outputs/ 폴더에 수집됩니다:

build/outputs/
├── desktop/
│   ├── app/    → CodeBlueprint.app (macOS 앱 번들)
│   ├── dmg/    → CodeBlueprint-1.0.0.dmg (설치 이미지)
│   └── jar/    → FatJar (실행 가능한 JAR)
└── android/
    ├── debug/  → androidApp-debug.apk
    └── release/→ androidApp-release.apk

프로젝트 구조

CodeBlueprint/
├── shared/                          # 공유 비즈니스 로직 (Clean Architecture)
│   └── src/
│       ├── commonMain/
│       │   ├── domain/              # UseCase, Repository Interface, Model
│       │   │   ├── model/           # DesignPattern, Algorithm, Settings 등
│       │   │   ├── repository/      # Repository 인터페이스
│       │   │   └── usecase/         # 비즈니스 로직
│       │   ├── data/                # Repository Impl, Mapper
│       │   │   ├── repository/      # Repository 구현체
│       │   │   ├── local/           # SQLDelight
│       │   │   └── interpreter/     # 코드 실행 인터프리터 (신규)
│       │   ├── presentation/        # ViewModel, UiState
│       │   └── di/                  # Koin 모듈
│       ├── androidMain/             # Android 전용 (SQLite Driver)
│       ├── desktopMain/             # Desktop 전용 (JDBC Driver)
│       └── iosMain/                 # iOS 전용 (Native Driver)
│
├── composeApp/                      # 공유 Compose UI
│   └── src/commonMain/
│       └── kotlin/.../ui/
│           ├── main/                # 메인 탭 화면 (패턴/알고리즘/아키텍처)
│           ├── pattern/             # 패턴 상세 화면
│           ├── algorithm/           # 알고리즘 상세 화면
│           ├── architecture/        # 아키텍처 패턴 화면
│           ├── search/              # 통합 검색 화면
│           ├── bookmarks/           # 북마크 화면
│           ├── settings/            # 설정 화면
│           ├── playground/          # 코드 플레이그라운드
│           ├── navigation/          # Decompose 네비게이션
│           └── theme/               # Material 3 테마
│
├── desktopApp/                      # macOS 앱 진입점
├── androidApp/                      # Android 앱 진입점
├── iosApp/                          # iOS 앱 진입점 (Swift)
│
└── tools/                           # Claude Code 연동 도구
    ├── mcp-server/                  # MCP 서버 (Node.js/TypeScript)
    │   ├── src/index.ts             # 9개 도구 제공
    │   └── data/                    # patterns.json, algorithms.json
    ├── mcp-cli/                     # CLI 도구 (Bash)
    │   ├── codeblueprint            # 메인 실행 파일
    │   └── completions/             # 자동완성 스크립트
    └── skill/                       # SKILL 레퍼런스
        ├── SKILL.md                 # 스킬 정의
        └── references/              # 패턴/알고리즘 문서

더 자세한 아키텍처 정보는 ARCHITECTURE.md를 참조하세요.

화면 구성

화면	설명
메인 (탭)	탭 기반 홈 화면: 패턴(23)/알고리즘(73)/아키텍처(5) 목록, 개수 표시
패턴 상세	패턴 설명, 장단점, 관련 패턴, 다국어 코드 예시
알고리즘 상세	알고리즘 설명, 시간/공간 복잡도, 코드 예시
아키텍처 상세	5개 아키텍처 패턴 비교 및 상세 설명
통합 검색	패턴과 알고리즘 동시 검색, 탭 UI로 결과 구분
코드 플레이그라운드	5개 언어 코드 편집 및 실행 시뮬레이션
북마크	저장한 패턴/알고리즘 관리
설정	테마, 기본 언어 설정

Claude Code 연동

CodeBlueprint는 Claude Code와 연동하여 디자인 패턴 및 알고리즘 코드를 생성할 수 있습니다.

MCP CLI

터미널에서 패턴/알고리즘 정보를 빠르게 조회할 수 있는 Bash 스크립트입니다.

# 패턴 목록
codeblueprint pattern list

# 패턴 상세
codeblueprint pattern get singleton

# 패턴 코드 예시
codeblueprint pattern code factory kotlin

# 알고리즘 목록
codeblueprint algorithm list sorting

# 알고리즘 검색
codeblueprint algorithm search 정렬

# 알고리즘 코드 예시
codeblueprint algorithm code quick-sort python

설치: PATH에 tools/mcp-cli 디렉토리 추가

요구사항: Bash 4.0+, jq (brew install jq)

MCP 서버

프로젝트의 tools/mcp-server/ 디렉토리에 MCP 서버 소스가 포함되어 있으며, 9개의 도구를 제공합니다:

# MCP 서버 빌드 및 실행
cd tools/mcp-server
npm install
npx tsc

도구	설명
`list_patterns`	카테고리별 패턴 목록 조회
`get_pattern`	패턴 상세 정보 조회
`get_code`	언어별 코드 예시 조회 (Kotlin, Java, Swift, Python)
`search_patterns`	키워드 기반 패턴 검색
`recommend_pattern`	상황에 맞는 패턴 추천
`list_algorithms`	카테고리별 알고리즘 목록 조회
`get_algorithm`	알고리즘 상세 정보 조회
`search_algorithms`	키워드 기반 알고리즘 검색
`recommend_algorithm`	문제에 맞는 알고리즘 추천

SKILL

프로젝트의 tools/skill/ 디렉토리에 SKILL 레퍼런스 문서가 포함되어 있습니다.

/pattern 또는 /algorithm 명령으로 코드를 생성할 수 있습니다:

# 패턴 관련
/pattern list              # 전체 패턴 목록
/pattern singleton         # Singleton 패턴 코드 생성
/pattern search 생성       # "생성" 키워드로 패턴 검색

# 알고리즘 관련
/algorithm list            # 전체 알고리즘 목록
/algorithm list sorting    # 정렬 알고리즘 목록
/algorithm quick-sort      # Quick Sort 코드 생성
/algorithm search 정렬     # "정렬" 키워드로 알고리즘 검색

라이선스

이 프로젝트는 MIT License 하에 배포됩니다.

개발 가이드

Claude Code 개발 가이드는 CLAUDE.md를 참조하세요.

Name		Name	Last commit message	Last commit date
.kotlin/sessions		.kotlin/sessions
androidApp		androidApp
app		app
composeApp		composeApp
desktopApp		desktopApp
docs		docs
gradle		gradle
iosApp/iosApp		iosApp/iosApp
scripts		scripts
shared		shared
tools		tools
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
README.md		README.md
build.gradle.kts		build.gradle.kts
gradle.properties		gradle.properties
gradlew		gradlew
gradlew.bat		gradlew.bat
settings.gradle.kts		settings.gradle.kts

Navigation Menu

Repository navigation

About

Repository files navigation

CodeBlueprint

스크린샷

macOS

주요 기능

디자인 패턴

알고리즘

아키텍처 패턴

코드 플레이그라운드

빠른 접근 및 검색

아키텍처

모듈 구조

Clean Architecture 레이어

데이터 흐름

기술 스택

시작하기

요구사항

빌드 및 실행

배포 빌드

프로젝트 구조

화면 구성

Claude Code 연동

MCP CLI

MCP 서버

SKILL

라이선스

개발 가이드

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

CodeBlueprint

스크린샷

macOS

주요 기능

디자인 패턴

알고리즘

아키텍처 패턴

코드 플레이그라운드

빠른 접근 및 검색

아키텍처

모듈 구조

Clean Architecture 레이어

데이터 흐름

기술 스택

시작하기

요구사항

빌드 및 실행

배포 빌드

프로젝트 구조

화면 구성

Claude Code 연동

MCP CLI

MCP 서버

SKILL

라이선스

개발 가이드

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages