bbl

blog & homepage project based on monorepo(Turborepo)

• bbl-nextjs

Links

• Homepage
  • https://bbl-nx.vercel.app/
• Storybook
  • Component, Features: https://bobeenlee.github.io/bbl/ui-components/
  • Features only: https://bobeenlee.github.io/bbl/features/

Feature

• Framework: Next.js (App Router)
• Deployment: Vercel
• Styling: Tailwind CSS
• Tooling: Storybook
• Build System: Turborepo

📂 Directory Structure

root
├── apps
├──── bbl-nextjs
├────── app            # App Router routes
├────── posts          # MD posts directory
├────── src
├──────── apis
├──────── components   # components with next ('use client' 경계)
├──────── libs
├──────── machines     # integrating machines with an api
├── libs
├──── features         # all of the code for a feature and putting it in one single place (ex) authentication - login, signup, user data...)
├──── constants        # 개인 데이터(경력·활동·스킬·포트폴리오·SEO 메타)
├──── hooks            # shared hooks
├──── images           # image assets
├──── libs             # third-party libraries (ex) fetch, sentry...) - facade pattern을 통한 구현
├──── ui-components    # general small components, presentational components (atoms, molecules, organisms, templates)
├──── utils            # very small and simple functions, generally pure function (ex) uri, browser)
├── tools
├──── generators       # plop-tempates 저장소
├── AGENTS.md          # 에이전트/기여자 작업 기준 (사실의 단일 출처)
└── README.md

Prerequisites

• node version 22.12.0

Installing / Getting started

pnpm install
pnpm install --registry=https://registry.npmjs.org/

Setting up Dev

pnpm dev

Tests

Running unit tests

pnpm test

Deployment

• Deploy to Storybook
  • github action develop 브랜치 기준 github pages로 배포 진행합니다.
  • ui-components: https://bobeenlee.github.io/bbl/ui-components/
  • features: https://bobeenlee.github.io/bbl/features/
• Deploy to Vercel
  • master 브랜치 기준 배포합니다.
  • https://bbl-nx.vercel.app/

Generate

pnpm components:new   # 컴포넌트 3파일 + 레이어 배럴 등록
pnpm post:new         # apps/bbl-nextjs/posts/<slug>.md

Supported browsers

• defaults: Browserslist’s default browsers (> 0.5%, last 2 versions, Firefox ESR, not dead).

Document

• Agent / Contributor Guide — 패키지 지도, 규약, 명령, 함정
• XState Machines
• Analytics Report

Gitflow

• git flow release start, finish 2.0.16
• git flow hotfix start, finish 2.0.16-hotfix.0

Contributors

BoBeenLee 💬 📝 🐛 💻 🎨 📖 📋 💡 💵 🔍 🤔 🚇 📦 🔌 👀 📢 ⚠️ 🔧 🌍 ✅ 📹