작은 작업실로 돌아가기
PROJECT / 01 · PIXEL WORLD EDITOR

ryu-deco✦

Decorate your GitHub, pixel by pixel.

개발자 소개와 기술 스택을 픽셀 월드로 꾸미고, 직접 그린 캐릭터와 애니메이션을 GitHub 프로필 README용 PNG·GIF로 내보내는 웹 에디터.

WHAT YOU CAN MAKE

작은 픽셀에서,
나만의 GitHub 월드로.

소개와 기술 스택을 배치하고, 캐릭터를 직접 그려 움직임을 더합니다. 완성한 장면은 README에 사용할 수 있는 이미지로 가져갑니다.

구현한 기능

  • 실시간 Canvas 편집
  • 배경 4종과 장식 배치
  • 16×16·32×32 픽셀 그리기
  • 프레임 애니메이션 편집
  • PNG·GIF 내보내기
  • 브라우저 자동 저장

사용한 기술

Next.jsTypeScriptTailwind CSSZustandCanvasgifenc

Next.js App Router와 strict TypeScript를 사용하고, 정적 내보내기로 GitHub Pages에 배포할 수 있도록 구성했습니다.

HOW I BUILT IT

어떻게 만들었나요?

AI를 활용한 부분과 직접 설계·구현한 부분을 나누어 제작 과정을 기록합니다.

AI ASSISTED

AI와 함께한 작업

확인된 작업 내용을 정리 중입니다.

HANDS ON

직접 설계·구현한 작업

확인된 작업 내용을 정리 중입니다.

BEHIND THE PIXELS

만들면서 풀어낸 문제들

01

미리보기와 내보내기를 같은 그림으로

해결할 문제
에디터에서 본 장면과 다운로드한 이미지가 다르면, 사용자는 결과물을 예측하기 어렵습니다.
구현 방식
Canvas의 공통 픽셀 렌더러로 미리보기, PNG, GIF 프레임을 그립니다. 선택 테두리는 편집 화면에서만 보여주고 내보낼 때는 제외합니다.
기술 선택의 이유
Canvas를 사용해 픽셀 단위의 배치와 이미지 출력을 하나의 렌더링 경로에서 처리합니다. GIF는 gifenc로 프레임을 인코딩합니다.
02

작은 그림이 움직이는 캐릭터가 되도록

해결할 문제
기본 캐릭터를 고르는 데서 나아가, 사용자가 자기만의 캐릭터와 움직임을 만들 수 있어야 합니다.
구현 방식
16×16·32×32 그리드, 연필과 지우개, 프레임 추가·복제·삭제를 제공합니다. 최대 8프레임을 편집하고, 그리드 크기를 바꿀 때는 nearest-neighbor 방식으로 픽셀을 변환합니다.
기술 선택의 이유
픽셀 데이터를 직접 관리해 확대해도 경계가 흐려지지 않게 합니다. 같은 그림을 여러 번 배치해도 원본 수정이 사본에 반영됩니다.
03

브라우저를 닫아도 이어지는 작업

해결할 문제
장면을 꾸미는 중 새로고침하거나 창을 닫아도 편집 내용을 다시 불러올 수 있어야 합니다.
구현 방식
Zustand로 편집 상태를 관리하고 localStorage에 자동 저장합니다. 배경, 효과, 출력 형식과 직접 그린 캐릭터도 저장하며 실행 취소·다시 실행을 지원합니다.
기술 선택의 이유
별도 로그인 없이 브라우저에서 바로 만들고 이어서 편집할 수 있습니다. 상태 관리와 픽셀 렌더링, 내보내기 코드를 분리했습니다.

이제, 나만의 작은 세계를 만들어 보세요.

ryu-deco 열기