보이지 않는 뒷면까지 투명하게, 웹사이트가 튼튼하게 만들어지는 원리

겉으로는 단순해 보이는 화면이 실제로는 어떻게 블록처럼 조립될까요?
코토노하가 일하는 방식 그대로 코드를 전혀 몰라도 쉽게 이해할 수 있는 뒷이야기를 만나보세요.

화면을 통째로 그리지 않고, 부품 단위로 조립합니다

페이지마다 버튼과 상자를 새로 그리면 나중에 문구 하나만 바꿔도 전체가 꼬입니다.
Astro 컴포넌트 기술을 활용해 공통 부품을 만들어두고 조립하는 방식을 소개합니다.

01그릇만 먼저 만들고 내용은 자유롭게 담기

모양 틀만 컴포넌트로 규격화해두고, 그 안에 들어갈 글이나 이미지는 Astro 슬롯 기능을 통해 언제든 자유롭게 갈아 끼웁니다.

02정해진 색과 크기 규칙으로 조립하기

페이지마다 여백이나 색상이 제각각 튀지 않도록, 엄격하게 정의된 디자인 토큰 규칙 안에서만 조립해 통일된 시각 언어를 지킵니다.

03부품 하나가 고장 나도 전체는 안전하게 지키기

각 컴포넌트가 외부 스타일에 휘둘리지 않고 독립적으로 완결성을 갖도록 캡슐화하여, 하나를 수정해도 다른 화면이 깨지지 않습니다.

CaseCard.astro & Badge.astro
Live Preview
업무 동선 최적화

수기 반복 작업을 데이터 파이프라인으로 전환

매일 몇 시간씩 걸리던 반복 입력이 클릭 한 번으로 끝났습니다.

01

기존 스프레드시트 환경을 해치지 않고 파이프라인을 설계해 실무자가 빠르게 적응할 수 있었습니다.

디자인 틀과 실제 글을 따로 보관합니다

문구 하나 고치려다 웹사이트 디자인이 와르르 깨진 적이 있으신가요?
TypeScript와 데이터 분리 설계를 통해, 글자를 아무리 고쳐도 사이트 디자인 틀은 절대 깨지지 않는 구조를 만듭니다.

01오타와 빈칸을 컴퓨터가 미리 검사하기

TypeScript를 사용해 데이터 형태를 엄격하게 약속해 둡니다. 필수 정보가 빠지거나 오타가 나면 화면을 띄우기도 전에 컴퓨터가 미리 잡아줍니다.

02복잡한 포장 없이 직관적으로 연결하기

불필요한 중간 포장 단계를 걷어내고, 작성해 둔 원본 글과 데이터가 화면으로 가장 단순하고 명쾌한 길을 통해 곧바로 이어지게 합니다.

03단 하나의 원본 장부만 단일 관리하기

여러 페이지에 복사해 붙이지 않고 src/data/*.ts라는 단 하나의 원본 장부에서 관리합니다. 원본만 바꾸면 사이트 전체가 알아서 바뀝니다.

work.astro (데이터 분리 적용 예시)
---
// src/data/work.ts에서 순수 데이터만 임포트 (SSOT)
import CaseCard from "../components/ui/CaseCard.astro";
import { problemSolutions } from "../data/work";

const item = problemSolutions[0];
---

<CaseCard
  anchor="01"
  badgeText="업무 동선 최적화"
  title={item.title}
  quote={item.clientQuote}
  topBorder="none"
>
  <p class="text-on-surface-variant font-medium leading-relaxed">
    {item.solution}
  </p>
</CaseCard>

겉모습만 화려한 것보다, 오래 가고 고치기 쉬운 구조가 중요합니다.

Astro와 TypeScript가 어떻게 협력하여 복잡함을 없애는지,
실제 컴포넌트와 코드를 직접 확인해 보세요.

*코토노하는 1인 사업개발자 JIYU의 실전 DX와 비즈니스 이야기를 담은 개인 블로그입니다.