fix(docs): 문서 사이트 배경 누락과 레이아웃·문구 정리

[Yeom-JinHo]

Changes

1. 스크롤 시 본문이 navbar를 관통하던 문제 (핵심)

원인은 --side-color-background-default가 선언은 되어 있으나 값이 비어 있는 것입니다. 테마 브릿지는 --color-background-default를 가리키는데 tokens.json은 같은 값을 color.background.base로 정의합니다. CSS 변수는 정의가 없어도 빈 값으로 조용히 해석돼 빌드·테스트를 통과했고, navbar 배경이 투명해졌습니다.

계약 불일치는 @sipe-team/tokens에서 고쳐야 하므로, 여기서는 값 레이어를 fallback으로 두어 우회합니다. 시맨틱 토큰이 정상화되면 fallback은 자동으로 빠집니다.

--ifm-navbar-background-color: var(--side-color-background-default, var(--color-background-base));

2. 크롬과 코드 표면 정리

• navbar 하단 경계선 추가 — 없어서 사이드바 세로선이 만날 가로선 없이 허공에서 시작했습니다
• 로고를 사이드바 항목과 같은 20px 축에 정렬 (기존 clamp()는 뷰포트에 따라 어긋났습니다)
• 코드블록 배경·radius를 토큰에 맞춤 — prism이 인라인 스타일로 #1e1e1e를 주입해 --ifm-pre-background를 덮고 있었습니다
• 사이드바 글자 크기를 한 단계 낮추고 활성 항목에 액센트 바 추가, 목차 인라인 코드의 배경 제거

3. 모바일에서 홈 카드가 맞붙던 문제

카드는 infima 그리드의 col을 쓰는데 col은 좌우 padding만 있고 세로 여백이 없습니다. 996px 이하에서 세로로 쌓이면 간격이 0이 됩니다. row에 row-gap을 주어 가로 간격과 같은 32px를 맞췄습니다. 한 줄에 들어가는 동안에는 발동하지 않아 데스크톱은 그대로입니다.

4. 한국어 문구 통일

사이트 로케일은 en 하나이고 문서도 모두 영어인데, 화면에 보이는 문구 두 곳만 한국어였습니다. 홈 히어로 부제는 같은 파일의 SEO description이 이미 영어라 한 파일 안에서도 어긋나 있었습니다.

Visuals

Checklist

• Have you written the functional specifications?
• Have you written the test code?

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
side	Ready	Preview	Aug 11, 2026 2:15pm
side-docs	Ready	Preview	Aug 11, 2026 2:15pm

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review (2)

• main
• release/v1

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: ASSERTIVE

Plan: Pro Plus

Run ID: a69522cb-e69f-47d1-8292-f79a86f60a96

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[changeset-bot]

⚠️ No Changeset found

Latest commit: 2562d51

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
see 3 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.