open-slide — 2026-10-05 갱신
Yiwei Ho(1weiho)의 에이전트 중심 React 발표 프레임워크. 사이트·문서·저장소·npm 메타데이터를 대조했다. 기존 북마크를 갱신하며 초기 메모는 아래에 보존한다.
현재 버전과 기술 구성
npm 최신 @open-slide/core 2.0.1, @open-slide/cli 2.0.0. v2 문서와 core 의존성은 React 19·Vite 8(Rolldown)·TypeScript·Tailwind CSS를 사용한다. Node engines는 ^20.19.0 || >=22.12.0이며 Node 18은 지원하지 않는다. 이전 북마크의 Next.js 중심 기술 설명은 현재 슬라이드 런타임 기준 React 19·Vite 8로 갱신한다. 코드 라이선스 MIT, 저작권 2026 Yiwei Ho. 프레임워크 사용료와 외부 코딩 에이전트·모델의 사용료는 별개다.
작성 구조와 애니메이션
각 페이지는 1920×1080 고정 캔버스에 렌더링되는 임의의 React 컴포넌트다. 제약된 슬라이드 DSL 대신 React·표준 웹 API로 레이아웃을 작성하고 화면 크기에 맞춰 캔버스를 비례 조정한다. 덱 위치: slides/<id>/index.tsx. 한 덱 파일이 여러 페이지 컴포넌트를 배열로 내보낼 수 있으며 에셋은 slides/<id>/assets/에 둔다. Page, Step, Transition, MorphElement 프리미티브로 페이지·단계별 등장·전환·형태 이동을 구성한다. 덱별 메타데이터·발표 노트와 재사용 테마를 함께 관리하고 파일 diff·Git 버전 관리에 연결한다.
시각 편집과 에이전트 댓글
개발 서버의 Inspector에서 요소 선택·드래그·크기·회전·정렬·분배·레이어와 스마트 가이드를 조작한다. 텍스트의 일부 문구 서식, 폰트 크기·굵기·색·행간·자간, 이미지 교체·크롭 등을 제공한다. 수정은 메모리에 대기하며 Save/Cmd·Ctrl+S로 소스에 기록한다. Preview 전환이나 덱 이탈 때도 대기 수정을 저장하며 Undo·Redo·Discard를 제공한다. 요소에 남긴 댓글은 런타임에서 보이지 않는 @slide-comment 소스 마커로 붙는다. /apply-comments가 이를 읽어 React 수정을 수행하도록 안내한다. 자산 관리자와 svgl 로고 검색도 제공한다. 문서의 '1500+ 로고'는 연동 기능 소개 수치이며 이번 작업에서 카탈로그 전체를 다시 세지는 않았다.
발표와 내보내기
Present에서 전체 화면·키보드 이동을 제공하고 발표자 창은 현재/다음 슬라이드·노트·경과 시간을 표시한다. open-slide build는 slides/와 사용 에셋·뷰어 런타임을 dist/ 정적 사이트로 만들어 파일 호스팅 서비스에 배포할 수 있다. 툴바 Export:
- HTML: 현재 덱의 정적 HTML 스냅샷. 에셋 참조가 있으면 HTML과 에셋 폴더를 ZIP으로 받는다.
- PDF: 페이지마다 1920×1080 가로 PDF 페이지. Safari는 지원하지 않는다고 문서에 명시한다.
- PPTX(images): 각 페이지를 이미지로 렌더링해 PowerPoint 슬라이드에 넣는다. 텍스트·도형 개체를 편집하는 native PPTX 내보내기는 아직 제공하지 않는다. 정적 빌드와 개발용 편집 기능은 구분한다. build 설정으로 덱 목록·화면 UI·다운로드 메뉴를 제어할 수 있다.
시작·스킬·업그레이드
npx @open-slide/cli init my-deck 생성한 워크스페이스에서 개발 서버를 열고 에이전트에게 /create-slide로 작성을 요청한 뒤 시각 편집 또는 댓글로 반복한다. 워크스페이스에는 AGENTS.md·CLAUDE.md와 스킬 5개가 제공된다: create-slide, slide-authoring, apply-comments, create-theme, current-slide. 스킬은 .agents/skills/에 있고 Claude Code용 .claude/skills/ 심볼릭 링크를 제공한다. 전역 에이전트 설정보다 프로젝트 안에서 버전 관리하는 방식이다. 명령: npm run dev, npm run build, npm run preview, npm run sync:skills. Claude Code·Codex·Cursor·Gemini CLI·OpenCode·Windsurf·Zed 등 React 파일을 편집하는 에이전트를 안내한다. 에이전트 작성 규칙은 덱별 경로·표준 React/웹 API 사용·다른 덱이나 설정을 변경하지 않는 범위를 정한다. v1→v2는 기존 슬라이드 소스를 유지하고 Node·package.json·배포 설정을 갱신하는 절차다. React 19 타입·의존성 갱신과 이전 Vite 직접 devDependency 제거를 안내한다. 이번 작업에서는 공개 문서·버전·라이선스와 커버를 확인했으며 설치·덱 생성·내보내기 실행은 하지 않았다.
기존 북마크와 관계
slidecn은 reveal.js 기반 슬라이드·래퍼·덱·테마 컴포넌트를 shadcn 레지스트리로 조립하는 자료다. open-slide는 자유로운 React 페이지에 개발 서버·Inspector·댓글·발표·내보내기까지 연결하는 전체 워크스페이스 도구라 기존 Kidow / Tools 분류를 유지한다. Deck Gallery는 발표 자료의 시각적 레퍼런스를 찾는 디렉터리로 함께 참고할 수 있다.
공식 자료·소스
사이트: https://open-slide.dev/ 소스: https://github.com/open-slide/open-slide 문서: https://open-slide.dev/docs Inspector: https://open-slide.dev/docs/core-feature/inspector 내보내기: https://open-slide.dev/docs/core-feature/export 발표: https://open-slide.dev/docs/core-feature/present-mode 스킬 5종: https://open-slide.dev/docs/skills/overview v2 이전: https://open-slide.dev/docs/migrate-to-v2 npm core: https://www.npmjs.com/package/@open-slide/core npm CLI: https://www.npmjs.com/package/@open-slide/cli 커버는 공식 사이트 Open Graph 이미지(1200×630 PNG)를 사용한다.
기존 메모 보존 — 초기 저장 2026-09-17
발표 자료를 코드로 관리하고 싶을 때. 슬라이드가 React 컴포넌트라 git으로 버전 관리되고 diff가 남는다. Claude Code로 "이 내용으로 슬라이드 만들어줘"를 시킬 수 있다. 에이전트 연동이 목적에 포함된 설계다. PowerPoint나 Keynote를 대체하는 물건은 아니다. 코드를 다루는 사람이 기술 발표를 만들 때의 선택지다. 협업자가 개발자가 아니면 맞지 않는다. 레이아웃 제약이 없다는 건 자유롭다는 뜻이면서 매번 직접 잡아야 한다는 뜻이기도 하다. 템플릿 기반 도구보다 초기 비용이 크다. Tools의 build로 두었다. 결과물(발표 자료)을 만들어내는 도구다. MIT라 부담이 없다.