실제 프론트매터와
TypeScript 아키텍처
화면을 구성하는 실제 프론트매터(데이터 주입)와 핵심 유틸리티 코드를 투명하게 공개합니다. 왜 Astro 프론트매터를 슬림하게 유지하고, TypeScript로 데이터 로직을 분리했는지 직접 확인해 보세요.
Astro 프론트매터 원본 직접 추출TypeScript 기반 데이터 안전 검증단일 진실 공급원(SSOT) 아키텍처
페이지 프론트매터 뷰어
좌측 목록에서 페이지를 선택하면, 해당 파일의 실제 프론트매터(데이터 정의, 임포트, 인터페이스)를 실시간으로 확인하실 수 있습니다.
페이지 목록
파일을 클릭하여 프론트매터를 전환하세요.
src/pages/index.astro•7 linesAstro Frontmatter
메인 랜딩 페이지 및 데이터 임포트 구조
import Layout from "../layouts/Layout.astro";
import Icon from "../components/ui/Icon.astro";
import BottomCTA from "../components/ui/BottomCTA.astro";
import Section from "../components/ui/Section.astro";
import Badge from "../components/ui/Badge.astro";
import SpeechBubble from "../components/ui/SpeechBubble.astro";
import { featuredCases, processSteps } from "../data/home";TypeScript 스크립트 & 유틸리티 로직
정적 데이터 배열을 배제하고, 소스코드 정적 추출 및 웹 뷰어 구문 강조 등 프로젝트의 실제 동작을 뒷받침하는 순수 TypeScript 유틸리티 로직입니다.
스크립트 목록
파일을 클릭하여 실제 TS 로직을 확인하세요.
src/utils/sourceInspector.ts•64 linesTypeScript Logic
디스크 원본 파일에서 프론트매터 및 코드를 정적 추출하는 유틸리티 로직
import fs from "node:fs";
import path from "node:path";
import {
PAGE_DEFINITIONS,
TS_MODULE_DEFINITIONS,
type PageMeta,
type TsModuleMeta,
} from "../data/sourcePages";
/**
* 디스크에서 실제 페이지 파일의 Frontmatter(--- 블록)를 정적으로 추출합니다.
*/
export function getPageSourceMetas(): PageMeta[] {
return PAGE_DEFINITIONS.map((item) => {
let frontmatter = "// 프론트매터를 읽어올 수 없습니다.";
let lineCount = 0;
try {
const fullPath = path.resolve(process.cwd(), item.path);
if (fs.existsSync(fullPath)) {
const content = fs.readFileSync(fullPath, "utf-8");
const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
if (match) {
frontmatter = match[1].trim();
lineCount = frontmatter.split("\n").length;
}
}
} catch (err) {
console.error(`[sourceInspector] Error reading ${item.path}:`, err);
}
return {
...item,
frontmatter,
lineCount,
};
});
}
/**
* 디스크에서 실제 TypeScript 모듈의 전체 코드를 정적으로 추출합니다.
*/
export function getTsSourceMetas(): TsModuleMeta[] {
return TS_MODULE_DEFINITIONS.map((item) => {
let code = "// TypeScript 코드를 읽어올 수 없습니다.";
let lineCount = 0;
try {
const fullPath = path.resolve(process.cwd(), item.path);
if (fs.existsSync(fullPath)) {
code = fs.readFileSync(fullPath, "utf-8").trim();
lineCount = code.split("\n").length;
}
} catch (err) {
console.error(`[sourceInspector] Error reading ${item.path}:`, err);
}
return {
...item,
code,
lineCount,
};
});
}보이지 않는 설계와 부품을 투명하게 공개합니다.
컴포넌트 라이브러리도 함께 확인해 보세요.
반복 패턴을 표준화한 공통 컴포넌트와 실시간 대화형 플레이그라운드를 제공합니다.
*코토노하는 1인 사업개발자 JIYU의 실전 DX와 비즈니스 이야기를 담은 개인 블로그입니다.