내 모든 앱을
같은 결로.

sonia-ui는 여러 앱·웹이 함께 쓰는 디자인 시스템이다. 색·간격·글자 크기를 한 곳에서 정하고, 웹은 Tailwind 클래스로, 앱은 Box·Text로 똑같이 쓴다.

직접 설치하기

복사한 프롬프트를 AI 에이전트에 붙여 넣으면 llms-full.txt 규칙대로 화면을 만든다.

테마를 눌러 보세요

오늘의 불씨

이번 주 5/7

42

연속으로 지킨 날

"작은 불씨가 큰 들을 태운다."

— 오늘의 명언

self-fire 앱 화면을 이 페이지와 같은 토큰으로 그렸다.

고른 테마는 이 사이트 전체에 기억된다.

시작하는 네 가지 방법

AI에게 맡기는 게 기본이다. 직접 설치한다면 프로젝트에 맞는 하나만 고른다.

AI에게 맡긴다

Claude Code 등에 아래 프롬프트를 붙여 넣는다. 에이전트가 llms-full.txt를 읽고 이 규칙대로 만든다.

sonia-ui로 만들어줘.
규칙과 사용법:
https://ckdtjs505.github.io/sonia-ui/llms-full.txt
llms-full.txt 열기

에이전트가 지키는 규칙

  • 색은 역할 이름으로: bg-primary, var(--color-surface)
  • 간격·모서리·글자는 단계 이름으로: p-lg, rounded-md, text-title
  • 버튼·카드·태그·입력은 sn-btn·sn-card·sn-tag·sn-input
  • hex·px는 쓰지 않는다. 테마는 <html data-theme> 하나로 바꾸고, 없으면 기기 설정을 따른다.

직접 설치한다면

설치 없이 두 줄

정적 페이지 <head>에 넣으면 색·sn-*·테마 선택까지 된다.

<link rel="stylesheet" href="https://cdn.jsdelivr.net/gh/ckdtjs505/sonia-ui@1/src/css/base.css">
<script src="https://cdn.jsdelivr.net/gh/ckdtjs505/sonia-ui@1/src/browser/theme.js"></script>

npm + Tailwind v4

설치 후 CSS에 두 줄만 넣는다.

npm i github:ckdtjs505/sonia-ui

/* app.css */
@import "tailwindcss";
@import "sonia-ui/tailwind.css";
Tailwind 없이 · Next.js

Expo 앱

같은 토큰 이름을 Restyle Box·Text로 쓴다.

npm i github:ckdtjs505/sonia-ui \
  @shopify/restyle \
  react-native-safe-area-context

import {
  ThemeProvider,
  getTheme,
  Box,
  Text,
} from "sonia-ui/native";

<ThemeProvider theme={getTheme("dark")}>
  <Box padding="lg">
    <Text variant="title">안녕</Text>
  </Box>
</ThemeProvider>
Expo 설정 전체

버튼 · 카드 · 태그 · 입력

클래스 두 개를 조합한다. Tailwind와 순수 CSS에서 이름이 같다. 위 테마를 바꾸면 여기도 함께 바뀐다.

디자인 메모
<button class="sn-btn sn-btn-primary">저장</button>
<button class="sn-btn sn-btn-soft">임시 저장</button>
<button class="sn-btn sn-btn-outline">취소</button>
<button class="sn-btn sn-btn-ghost">더 보기</button>

<span class="sn-tag">디자인</span>
<span class="sn-tag sn-tag-muted">메모</span>

<div class="sn-card flex flex-col gap-s">
  <label for="todo" class="text-label">할 일</label>
  <input
    id="todo"
    class="sn-input"
    placeholder="오늘 할 일을 적는다"
  />
</div>
크기·pill·카드까지 전체 보기

이미 이 값으로 돌아가는 곳

Sonia.dev 블로그에 숲 테마를 적용한 화면 Sonia.dev 블로그 ckdtjs505.github.io · themes.css
self-fire
Expo · native
planner
base.css 인라인
ai-tutor
Next · base.css + CDN theme.js
csfreecaTV
CDN
Momentum
CDN
이 문서 사이트
tailwind.css

이름만 알면 된다

색·간격·모서리·글자 모두 정해진 이름으로 쓴다. 전체 표는 각 문서에 있다.

bg-primary

주요 강조

bg-primary-soft

보조·태그 배경

bg-background

화면 바탕

bg-surface-muted

들어간 면

p-s
p-lg
p-xl

xs부터 hg까지 같은 이름을 p-·m-·gap-에 쓴다.

rounded-sm

버튼·입력

rounded-md

카드

rounded-pill

태그·칩

text-title화면 제목
text-body본문 글자
text-caption설명과 보조 글자

AI와 쓰기

새 화면이 필요하면, 규칙부터 건넨다

이 문서 사이트도 같은 토큰과 sn-*로 만들었다. 직접 붙이려면 설치 문서에서 시작한다.

sonia-ui AI와 쓰기 문서 페이지 화면