시작 가이드
내려받기부터 실행 · 모듈 추가 · 설정값 · 실제 백엔드 연결 · 디자인 · 업데이트까지, 처음 하루에 필요한 순서입니다.
가격 페이지에서 필요한 판을 PayPal 로 구매합니다. 한 번 구매이며 구독이 아닙니다.
머리의 내 계정 → 내 상품에서 최신 버전을 받습니다. React · Vue · Next.js 판의 zip 에는 판 폴더와 공용 가상 백엔드(initfn-mock)가 나란히 들어 있습니다.
initfn-react-1.0.0/
initfn-react/ # React edition
initfn-mock/ # mock backend (found at ../initfn-mock - keep both side by side)Node.js 24 (각 판의 .nvmrc) · npm. Vanilla 판은 필요 없습니다.
가상 백엔드를 먼저 켜고 앱을 띄웁니다. 계정은 admin / 1234.
cd initfn-mock && npm i && cd ..
cd initfn-react && npm i # initfn-vue for Vue
npm run mock # mock backend http://localhost:4000
npm run dev # React :4001 · Vue :4003 · docs at /doc별도 백엔드 없이 Next 서버 하나로도(모놀리스), 가상 백엔드에 붙여서도 시작할 수 있습니다.
cd initfn-nextjs && npm i
npm run mock # when using the mock backend
npm run dev # http://localhost:4002 · docs at /doc빌드가 없습니다. _guide 폴더의 HTML 을 브라우저로 열어 컴포넌트 사용법과 예시 소스를 보고, css · js · font 폴더를 페이지에 연결합니다.
React · Vue · Next.js 판은 50개 모듈을 명령으로 넣고 뺍니다. 화면 · API · 메뉴가 같이 들어오고 같이 빠집니다.
npm run preset # list modules
npm run preset add social-login mfa # add
npm run preset remove mfa # removeReact · Vue · Next.js 판의 설정값은 세 파일에 나눠 둡니다. .env 는 개발 · 운영 공통(사이트 이름처럼 비밀이 아닌 값), .env.development 는 개발에서만, .env.production 은 운영에서만 쓰는 값입니다. 세 파일 모두 git 에 올리지 않고, 내 컴퓨터에서만 바꿀 값은 .env.local 에 둡니다.
.env # shared, not secret - site name, public IDs
.env.development # dev only - local backend URL, sandbox keys
.env.production # production only - live URL, live keys, analytics ID
.env.local # your machine only (overrides the others)모듈을 넣으면 그 모듈에 필요한 설정 키가 알맞은 파일 끝에 설명 주석과 함께 들어가고, 끝나면 채워야 할 키를 알려 줍니다. 이미 있는 값은 건드리지 않고, 모듈을 빼도 값은 지우지 않습니다.
npm run preset add paypal
# -> adds PAYPAL_* keys to .env.development
# and .env.production, then lists keys to fill백엔드 주소는 core/config/apiConfig.js 의 표 한 줄과 .env.development(운영은 .env.production)의 주소 한 줄입니다. 화면 코드는 바꾸지 않습니다.
# .env.development (production: .env.production)
BACKEND_API_URL=http://your-backend:8080initfn-mock/openapi.yaml 이 프론트가 기대하는 API 입니다. 백엔드 개발자에게 이 문서를 건네면, 그대로 응답하는 백엔드에는 코드 수정 없이 붙습니다.
스타일은 세 단계로 나뉩니다. 색 · 글꼴 · 모서리 · 그림자 같은 값은 initfn-token.css, 버튼 · 입력 · 카드 · 블록 같은 작은 UI 모양은 initfn-base.css, 페이지 · 섹션 같은 큰 디자인은 initfn-global.css 에 씁니다. 브랜드 색만 바꾸려면 token 파일 맨 아래의 --color-brand-* 만 고치면 됩니다.
src/core/style/ # Vanilla: css/ · font/ · image/
css/initfn-token.css # values - colors, fonts, radius, shadows
css/initfn-base.css # small UI, components, blocks
css/initfn-global.css # pages and sections
font/ image/시안이나 원하는 느낌을 주고, 판에 들어 있는 디자인 스킬을 읽고 바꿔 달라고 하면 됩니다. 이 스킬이 요청마다 어느 파일을 고칠지 정해 두어, AI 가 화면 코드는 그대로 두고 이 세 파일을 고칩니다.
.claude/skills/ssr-design/ # Next.js
.claude/skills/csr-design/ # React
.claude/skills/vue-design/ # Vue
.claude/skills/vanilla-design/ # VanillaCSS 는 규칙 하나를 한 줄로 씁니다(토큰 파일만 줄바꿈). VS Code 에서는 저장할 때 자동으로 정리됩니다. 글꼴은 Pretendard 를 화면에 필요한 글자 조각만 받아 첫 화면 글꼴이 약 1MB 이고, React · Vue · Next.js 판은 공통 Image 컴포넌트를 쓰면 이미지가 지연 로딩 · avif/webp 로 가볍게 나갑니다.
npm run format # tidy CSS - one rule per line
node scripts/format-css.mjs # VanillaReact · Vue · Next.js 판은 새 판 zip 의 .preset 폴더로 내 프로젝트의 .preset 을 덮어쓴 뒤 update 하면 됩니다. 목록의 ⬆ 는 새 판이 나온 설치 모듈, 🆕 는 새로 생긴 모듈입니다. 내가 고친 파일은 덮지 않고 옆에 .preset-new 로 두니, 비교해서 합친 뒤 지우세요.
# 1. copy .preset from the new zip over your project's .preset
npm run preset # 2. list - ⬆ update available · 🆕 new module
npm run preset update # 3. update installed modules
npm run preset add <name> # 4. add a new module
npm run lint && npm test && npm run build어떤 모듈을 어느 판으로 넣었는지는 프로젝트 루트의 preset.lock.json 에 남습니다. .preset 폴더를 통째로 덮어써도 기록이 남도록 폴더 밖에 두었으니 git 에 같이 올리세요.
core · shared 같은 기본 코드의 개선까지 받으려면, 받은 zip 을 git 저장소로 시작하고 원본 그대로를 initfn 브랜치에 둡니다. 내 작업은 main 에서 합니다.
git init && git add . && git commit -m "initfn 1.0.0"
git branch initfn # untouched original계정에서 새 zip 을 받아 initfn 브랜치에 덮어쓴 뒤 main 으로 합치고, npm run preset update 로 설치한 모듈도 맞춥니다. 내가 고친 곳과 겹치는 부분만 충돌로 보입니다. 바뀐 내용은 릴리스 노트에 있습니다.
git switch initfn
# unzip the new version over it (keep node_modules and your .env files)
git add -A && git commit -m "initfn 1.1.0"
git switch main && git merge initfn
npm run preset update # sync installed modules판마다 같은 이름의 명령이 있습니다.
npm run lint && npm test # rules and unit tests
npm run build # production build
npm run test:e2e # browser E2E배포 방법은 앱 안의 개발 가이드(/doc)에 있습니다. 결과물을 배포 · 납품할 때는 판 안의 THIRD_PARTY_NOTICES.md(오픈소스 고지)를 함께 제공하세요.
아주 자세한 설명은 프로젝트 압축 파일에 같이 들어 있습니다. 이 페이지는 처음 하루에 필요한 순서만 간추렸습니다. 설치 · 설정 · 컴포넌트 · 모듈 · 배포까지 전부, 내려받은 압축 파일 안의 가이드 사이트(7개 언어) · README · AI 코딩 도구용 문서(AGENTS.md)에서 볼 수 있습니다.
자주 묻는 질문 · 라이선스를 보거나 numerxlab@gmail.com 로 알려 주세요.