Motion 워크스페이스
이 워크스페이스는 mg CLI(pnpm mg <command>)를 통해 Remotion으로 반복 가능한 모션 그래픽을 렌더링합니다. 디자인은 코드 템플릿으로 이루어지며, 모든 작업별 값은 JSON에 저장됩니다. 텍스트, 색상 또는 폰트 변경은 JSON 편집 후 pnpm mg render만 실행하면 되며, 코드 변경이 필요 없습니다.
레이아웃
mg.json 워크스페이스 비디오 기본값(fps, 크기)
brand/house.tokens.json 하우스 토큰: 기본 색상, 폰트, 이징, 지속 시간, 안전 영역
brand/fonts/ brand/logos/ 하우스 토큰이 참조하는 파일들
clients/<client>/
client.json 표시 이름, 선택적 비디오 오버라이드
brand/tokens.json 클라이언트 오버라이드(하우스 위에 딥 병합)
brand/fonts/ brand/logos/
brand/variants/<variant>/ 여러 프로젝트에서 재사용하는 명명된 대체 룩: tokens.json, fonts/, logos/
templates/<name>/index.tsx 클라이언트 전용 템플릿, id "<client>/<name>"
projects/<project>/
project.json { title?, extends?: "client"|"none", brand?: "<variant>", video?, preset? }
tokens.json 프로젝트 전용 오버라이드(선택사항)
tokens.lock.json 고정 시 존재: 렌더링이 라이브 체인 무시
fonts/ logos/ assets/ 프로젝트 파일; props는 "asset:<경로>"로 자산 참조
shots/<shot>.props.json { template, props, durationSeconds?, preset?, video? }
renders/ 출력물, git 무시; manifest.json이 버전 추적
툴킷 코드(엔진, 하우스 템플릿, 이 스킬들)는 node_modules/motion-toolkit에 있으며, package.json에 의해 고정됩니다. 절대 그곳에서 편집하지 마세요. 하우스 템플릿 변경은 툴킷 저장소로 가야 합니다.
하우스 템플릿
모든 하우스 템플릿에는 look prop이 있습니다: minimal(깔끔함, 가벼운 두께, 블러-라이즈, 패널 없음), bold(굵은 대문자, 단색 블록, 스프링 팝), corporate(패널, 악센트 바, 마스크 리빌). 기본값 "brand"는 look 토큰을 사용하므로, 클라이언트는 brand/tokens.json에서 한 번만 스타일을 설정하면 됩니다("look": "minimal").
| Id | 용도 |
|---|---|
lower-third | 이름 및 직책 스트랩, 선택적 로고 |
title-card | 챕터 또는 섹션 제목, 선택적 킥커 및 부제목; 오버레이 또는 전체 프레임 |
callout | 영상의 한 지점(x, y: 프레임 비율)에서 레이블로 이어지는 선 |
end-card | 종료 카드: 로고, 헤드라인, CTA, URL, 0~2개의 YouTube 엔드스크린 슬롯 |
kinetic-text | 인용구 또는 문장이 단어별로 나타남; *단어*는 강조 |
logo-sting | 짧은 애니메이션 로고 리빌(인트로/아웃트로) |
counter | 숫자 카운트업(value, prefix, suffix, decimals)과 레이블 |
social-handle | 플랫폼 아이콘 + @핸들을 모서리에 표시(YouTube, Instagram, TikTok, X, LinkedIn 등) |
typewriter | 텍스트가 키별로 타이핑되며 렌더링 오디오에 타자기 또는 키보드 사운드 포함 |
corner-branding | 모든 모서리에 지속적인 로고 버그, 선택적 태그(LIVE 등) |
pnpm mg new-shot … --template <id>는 모든 prop을 기본값으로 작성합니다. 각 prop의 의미는 node_modules/motion-toolkit/templates/<id>/index.tsx의 .describe() 텍스트에 있습니다.
토큰 체인
toolkit → house → client → variant (project.json "brand"인 경우) → project tokens.json → shot props. 툴킷 계층은 기본값만 제공합니다(look, mono 폰트, 타이핑 sounds). 객체는 키별로 병합되고, null은 상속된 키를 삭제하며, 가장 구체적인 계층이 우선합니다. "extends": "none"은 클라이언트와 변형을 건너뜁니다. 폰트, 로고 및 사운드 파일은 해당 파일을 가진 가장 구체적인 계층의 fonts/, logos/ 또는 sounds/ 폴더에서 찾습니다.
규칙
- 모든 시각적 값은 샷 props 또는 토큰에서 와야 합니다. 하드코딩된 색상, 폰트, px 단위 크기(prop 없음) 또는 타이밍이 템플릿에 없어야 합니다.
- 프로젝트는 데이터를 보관하고, 코드를 보관하지 않습니다. 새로운 디자인은 템플릿이고, 새로운 작업은 샷 파일이 있는 프로젝트입니다.
- 값을 소유한 가장 낮은 계층에 배치합니다: 하나의 샷 → 샷 props; 하나의 프로젝트 → 프로젝트
tokens.json; 클라이언트의 여러 프로젝트 → 변형; 전체 클라이언트 → 클라이언트 토큰. tokens.lock.json을 수동으로 편집하지 마세요. 전달된 프로젝트는 고정되어 있으며,mg rebrand를 통해서만 변경됩니다(motion-render참조).- 모든 JSON 또는 템플릿 편집 후, 렌더링 전에
pnpm mg check를 실행하고 보고된 문제를 수정하세요. - 모든 시각적 변경은 완료 보고 전에
motion-qa절차를 수행하세요. mg rebrand --apply전과 고정된 프로젝트에서 사용하는 클라이언트 또는 변형 토큰을 편집하기 전에 사용자에게 질문하세요.- 렌더링 또는 doctor 검사가 실패하면, 코드를 변경하기 전에
pnpm mg doctor를 실행하세요.
라우트
| 작업 | 읽을 문서 |
|---|---|
| 새 클라이언트, 변형, 로고, 폰트, 색상 팔레트 | motion-brand |
| 브리프로부터 새 프로젝트 또는 샷; 기존 샷의 텍스트/색상 변경 | motion-project |
| 새 템플릿 또는 템플릿 애니메이션 방식 변경 | motion-template, 그 다음 motion-style |
| 모션 느낌: 이징, 타이밍, 스태거, 안전 영역 | motion-style |
| 렌더링, 프리셋, 버전, 전달, 브랜드 변경 적용 | motion-render |
| 인계 전 출력 확인 | motion-qa |
명령어
pnpm mg templates 템플릿 ID 목록
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <client>/<project> <shot> --template <id> 모든 prop이 기본값인 샷 파일
pnpm mg new-template <client> <name> 시작 템플릿
pnpm mg check [<client> | <client>/<project>] 렌더링 없이 모든 것 검증
pnpm mg render <client>/<project> [shot…] 변경되지 않은 샷 건너뜀; --force, --preset
pnpm mg still <client>/<project> [shot…] 체커보드 위에 PNG 미리보기(기본값: 모든 샷)
pnpm mg studio <client>/<project> 라이브 프리뷰; 스튜디오 "저장"이 샷 파일 작성
pnpm mg deliver <client>/<project> 렌더링, 확인, 고정, 최종본을 deliver/<날짜>/로 복사
pnpm mg rebrand <client | client/project> [--apply] 전달된 작업에 대한 브랜드 변경
pnpm mg freeze|unfreeze|diff <client>/<project>
pnpm mg doctor 환경, mg check, 스모크 렌더