Skip to content

jadru/brand-kit

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

BrandKit

CI Next.js 16 TypeScript strict

브랜드 정보를 한 번 입력하면 웹·모바일용 아이콘, favicon, OG image, PWA manifest와 적용 코드를 생성해 ZIP으로 전달하는 SaaS 제품입니다.

Live product · Try the public demo · Architecture

제품 흐름

  1. 브랜드 이름, 설명과 스타일을 정의합니다.
  2. Web, Mobile 또는 전체 플랫폼을 선택합니다.
  3. AI copy·icon과 파생 asset을 생성합니다.
  4. 미리보기로 결과를 확인하고 적용 코드가 포함된 ZIP을 받습니다.
BrandKit platform selection step BrandKit generated asset preview
플랫폼별 asset wizard 생성 결과 preview와 ZIP download

Engineering highlights

  • 명시적인 경계: TypeScript strict mode를 사용하고 form 입력은 Zod schema로 검증합니다.
  • 분리된 asset pipeline: favicon, OG image, PWA, app icon, splash와 code snippet 생성을 독립 모듈로 나누고 마지막 단계에서 ZIP으로 조합합니다.
  • 안전한 delivery: GitHub Actions가 lint, type check, Vitest와 production build를 모두 통과해야 완료됩니다.
  • 배포 후 검증: production QA script가 public route, locale redirect, SEO endpoint, image response와 ZIP 내부 파일 계약을 실제 배포 URL에서 확인합니다.
  • 보안 경계: Supabase Auth·RLS로 사용자 데이터를 격리하고, 결제 webhook은 HMAC signature를 constant-time으로 검증합니다.

기술 스택

영역 기술
Web Next.js 16, React 19, TypeScript, Tailwind CSS v4
State & Form Zustand, React Hook Form, Zod
Data Supabase PostgreSQL, Auth, Storage
AI & Payment Anthropic, FAL.ai, LemonSqueezy
Quality Vitest, Testing Library, ESLint, GitHub Actions
Delivery Vercel, production QA script

로컬 실행

요구사항

  • Node.js 22.12+
  • Yarn 4+
  • Supabase project
yarn install
cp .env.example .env.local
yarn dev

필요한 환경변수와 server/client 노출 경계는 .env.example에 정리되어 있습니다.

검증

yarn lint
yarn tsc --noEmit
yarn test
yarn build

# 배포된 제품의 route·binary contract 확인
yarn qa:preview https://brand-kit.jadru.com

프로젝트 구조

app/                    Next.js pages, server actions, API routes
components/             Product UI and reusable primitives
lib/
  ai/                   AI provider boundaries and prompt configuration
  assets/               Asset generation and ZIP packaging pipeline
  security/             Rate limiting and security helpers
  supabase/             Server/client data access
store/                  Wizard client state
tests/                  API, component, configuration and asset tests
docs/                   Architecture decisions, guides and QA reports

주요 문서

License

소스 코드는 공개되어 있지만 별도의 오픈소스 라이선스는 부여하지 않았습니다.

About

Next.js and TypeScript SaaS for generating web and mobile brand assets, with Vitest, CI, and production QA.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors