Skip to content

Conversation

@dasosann
Copy link
Contributor

@dasosann dasosann commented Jan 27, 2026

PR Type

Enhancement


Description

  • 토큰 생성 스크립트 완전 개선 및 CSS 변수 정리

    • 중복 제거, 유효성 검사, 알파벳 순 정렬 추가
    • 재귀적 토큰 탐색으로 더 많은 토큰 수집 (132개)
  • Blur 배경 컴포넌트 추가 및 레이아웃 통합

    • 주황색/분홍색 그래디언트 블러 효과 구현
  • 배경색 및 텍스트 색상 유틸리티 클래스 대폭 확대

    • 모든 색상 토큰에 대한 자동 생성 유틸리티
  • 개발 편의성 향상 (pnpm 스크립트 추가)


Diagram Walkthrough

flowchart LR
  A["token.json"] -->|재귀적 탐색| B["generate-tokens.js"]
  B -->|중복 제거 및 정렬| C["tokens.css"]
  C -->|CSS 변수| D["Tailwind 유틸리티"]
  D -->|배경/텍스트 색상| E["컴포넌트"]
  F["Blur 컴포넌트"] -->|배경 효과| E
  G["layout.tsx"] -->|Blur 통합| E
Loading

File Walkthrough

Relevant files
Enhancement
generate-tokens.js
토큰 생성 스크립트 완전 개선                                                                                 

scripts/generate-tokens.js

  • 토큰 수집 로직을 재귀적 탐색으로 개선하여 132개 토큰 자동 추출
  • 중복 방지를 위해 Map 기반 저장소 도입 및 유효성 검사 추가
  • CSS 변수명 정제 함수 강화 (괄호 제거, 특수문자 처리)
  • 배경색, 텍스트 색상, 보더 유틸리티 자동 생성 로직 추가
  • 생성 결과 통계 및 개선사항 로깅 추가
+175/-147
tokens.css
CSS 변수 및 유틸리티 클래스 대폭 확대                                                                   

app/tokens.css

  • CSS 변수 417개로 대폭 확대 (기존 260개에서 증가)
  • 배경색 유틸리티 클래스 40개 이상 추가 생성
  • 텍스트 색상 유틸리티 클래스 40개 이상 추가 생성
  • 보더 색상 유틸리티 클래스 추가
  • 변수명 알파벳 순 정렬 및 구조 정리
+366/-209
Blur.tsx
Blur 배경 효과 컴포넌트 추가                                                                             

components/common/Blur.tsx

  • 새로운 Blur 컴포넌트 생성 (배경 효과용)
  • 주황색 및 분홍색 그래디언트 블러 효과 구현
  • 절대 위치 배치로 배경 레이어 구성
  • pointer-events-none으로 상호작용 방지
+14/-0   
layout.tsx
Blur 컴포넌트 레이아웃 통합                                                                               

app/layout.tsx

  • Blur 컴포넌트 import 및 레이아웃에 통합
  • 배경색을 bg-background-app-base 토큰으로 변경
  • 메인 컨테이너에 relative 클래스 추가 (Blur 절대 위치 기준)
  • 불필요한 md: 반응형 클래스 제거
+4/-2     
page.tsx
페이지 구조 간소화                                                                                             

app/page.tsx

  • 기존 토큰 테스트 섹션 완전 제거
  • 간단한 구조로 리팩토링 (Blur 컴포넌트만 유지)
  • 페이지 복잡도 대폭 감소
+5/-59   
Configuration changes
package.json
토큰 생성 npm 스크립트 추가                                                                               

package.json

  • token 스크립트 추가 (pnpm run token으로 토큰 생성)
  • 기존 node 직접 실행 방식에서 npm 스크립트로 변경
+2/-1     


✨ Describe tool usage guide:

Overview:
The describe tool scans the PR code changes, and generates a description for the PR - title, type, summary, walkthrough and labels. The tool can be triggered automatically every time a new PR is opened, or can be invoked manually by commenting on a PR.

When commenting, to edit configurations related to the describe tool (pr_description section), use the following template:

/describe --pr_description.some_config1=... --pr_description.some_config2=...

With a configuration file, use the following template:

[pr_description]
some_config1=...
some_config2=...
Enabling\disabling automation
  • When you first install the app, the default mode for the describe tool is:
pr_commands = ["/describe", ...]

meaning the describe tool will run automatically on every PR.

  • Markers are an alternative way to control the generated description, to give maximal control to the user. If you set:
pr_commands = ["/describe --pr_description.use_description_markers=true", ...]

the tool will replace every marker of the form pr_agent:marker_name in the PR description with the relevant content, where marker_name is one of the following:

  • type: the PR type.
  • summary: the PR summary.
  • walkthrough: the PR walkthrough.
  • diagram: the PR sequence diagram (if enabled).

Note that when markers are enabled, if the original PR description does not contain any markers, the tool will not alter the description at all.

Custom labels

The default labels of the describe tool are quite generic: [Bug fix, Tests, Enhancement, Documentation, Other].

If you specify custom labels in the repo's labels page or via configuration file, you can get tailored labels for your use cases.
Examples for custom labels:

  • Main topic:performance - pr_agent:The main topic of this PR is performance
  • New endpoint - pr_agent:A new endpoint was added in this PR
  • SQL query - pr_agent:A new SQL query was added in this PR
  • Dockerfile changes - pr_agent:The PR contains changes in the Dockerfile
  • ...

The list above is eclectic, and aims to give an idea of different possibilities. Define custom labels that are relevant for your repo and use cases.
Note that Labels are not mutually exclusive, so you can add multiple label categories.
Make sure to provide proper title, and a detailed and well-phrased description for each label, so the tool will know when to suggest it.

Inline File Walkthrough 💎

For enhanced user experience, the describe tool can add file summaries directly to the "Files changed" tab in the PR page.
This will enable you to quickly understand the changes in each file, while reviewing the code changes (diffs).

To enable inline file summary, set pr_description.inline_file_summary in the configuration file, possible values are:

  • 'table': File changes walkthrough table will be displayed on the top of the "Files changed" tab, in addition to the "Conversation" tab.
  • true: A collapsable file comment with changes title and a changes summary for each file in the PR.
  • false (default): File changes walkthrough will be added only to the "Conversation" tab.
Utilizing extra instructions

The describe tool can be configured with extra instructions, to guide the model to a feedback tailored to the needs of your project.

Be specific, clear, and concise in the instructions. With extra instructions, you are the prompter. Notice that the general structure of the description is fixed, and cannot be changed. Extra instructions can change the content or style of each sub-section of the PR description.

Examples for extra instructions:

[pr_description]
extra_instructions="""- The PR title should be in the format: '<PR type>: <title>'
- The title should be short and concise (up to 10 words)
- ...
"""

Use triple quotes to write multi-line instructions. Use bullet points to make the instructions more readable.

More PR-Agent commands

To invoke the PR-Agent, add a comment using one of the following commands:

  • /review: Request a review of your Pull Request.
  • /describe: Update the PR title and description based on the contents of the PR.
  • /improve [--extended]: Suggest code improvements. Extended mode provides a higher quality feedback.
  • /ask <QUESTION>: Ask a question about the PR.
  • /update_changelog: Update the changelog based on the PR's contents.
  • /help_docs <QUESTION>: Given a path to documentation (either for this repository or for a given one), ask a question.
  • /add_docs 💎: Generate docstring for new components introduced in the PR.
  • /generate_labels 💎: Generate labels for the PR based on the PR's contents.
  • /analyze 💎: Automatically analyzes the PR, and presents changes walkthrough for each component.

See the tools guide for more details.
To list the possible configuration parameters, add a /config comment.

See the describe usage page for a comprehensive guide on using this tool.

@qodo-code-review qodo-code-review bot added the enhancement New feature or request label Jan 27, 2026
@gemini-code-assist
Copy link
Contributor

Summary of Changes

Hello @dasosann, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request enhances the application's visual appeal by introducing a new global Blur component, providing a subtle background effect. Concurrently, it brings a major improvement to the design system by overhauling the token generation script. This refactor ensures a more consistent, comprehensive, and maintainable set of CSS variables and Tailwind utility classes, streamlining future styling efforts and improving the overall development experience.

Highlights

  • New Global Blur Component: A new Blur React component has been introduced to add subtle background visual effects, which is now integrated into the main application layout (app/layout.tsx).
  • Design Token System Overhaul: The token generation script (scripts/generate-tokens.js) has been significantly refactored for improved robustness, including better key sanitization, reference resolution, deduplication, and automatic generation of a wider range of CSS variables and Tailwind utility classes in app/tokens.css.
  • Simplified Home Page: The app/page.tsx file has been cleaned up, removing extensive design token test content and now primarily serving as a container for the new Blur component.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Contributor

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

Hello. I have conducted a code review focusing on overall improvements. The token generation script has been improved recursively, and the addition of duplication removal and validation has resulted in a very clean and scalable structure, which is impressive. The addition of the Blur component and layout integration are also well done. However, I have identified a few improvements that can further enhance code quality and stability, and I have left comments below. Please check them.

Comment on lines 77 to +97
function resolveValue(value, depth = 0) {
if (depth > 10 || typeof value !== "string") return value;

const match = value.match(/^\{(.+)\}$/);
if (!match) return value;

const ref = match[1];

// Grayscale 참조
if (ref.startsWith("Grayscale.")) {
const key = ref.replace("Grayscale.", "");
return `var(--${key})`;
const parts = ref.split(".");
const lastPart = parts[parts.length - 1];
const tokenName = sanitizeKey(lastPart);

// tokenMap에서 찾기
for (const [key, token] of tokenMap.entries()) {
if (token.name === tokenName) {
return `var(--${token.name})`;
}
}

// Colors 참조
if (ref.startsWith("Colors.Pink.")) {
const key = ref.replace("Colors.Pink.", "");
return `var(--${key})`;
}
if (ref.startsWith("Colors.Flame.")) {
const key = ref.replace("Colors.Flame.", "");
return `var(--${key})`;
}
if (ref.startsWith("Colors.Orange.")) {
const key = ref.replace("Colors.Orange.", "");
return `var(--${key})`;
// 못 찾으면 그대로 반환
return value;
}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

high

The token generation script is producing invalid CSS values in the app/tokens.css file. For example, values like --bg: {colors.indigo.200}; or --h3: roundTo({fontSizes.body}*1.25^3); are included without proper filtering.

Reason:
The resolveValue function attempts to find tokens using only the last part of the full path (200) when resolving token references, instead of the full path (colors.indigo.200). This approach makes the reference ambiguous, and names that are just numbers are considered invalid variable names, causing the resolution to fail. Also, expressions like roundTo() are not currently handled by the script.

Suggestion:

  1. Modify the resolveValue function to use the full path of the reference to recursively traverse the token.json object and find the correct value.
  2. Since values containing expressions (e.g., roundTo) cannot be processed by the current script, it's recommended to add logic to output a warning and exclude them from CSS variable generation.

<html lang="ko" className={pretendard.variable}>
<body
className={`${pretendard.className} flex justify-center bg-white antialiased md:bg-gray-100`}
className={`${pretendard.className} antialiase flex justify-center bg-white`}
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

There's a typo in the style class. antialiase should be corrected to antialiased. Tailwind CSS's anti-aliasing utility is antialiased. This typo can cause the font rendering to look different from what was intended.

Additionally, according to the repository style guide (line 55), consider using a utility like clsx or cn when combining multiple classes. For example, you can use it like this: cn(pretendard.className, 'antialiased', ...).

Suggested change
className={`${pretendard.className} antialiase flex justify-center bg-white`}
className={`${pretendard.className} antialiased flex justify-center bg-white`}
References
  1. When using conditional styling, it is recommended to use clsx or tailwind-merge (or the cn utility). Although this is a simple string concatenation, consider using a utility for consistency. (link)

Comment on lines +5 to +7
<main>
<Blur />
</main>
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The <Blur /> component is being rendered redundantly. This component is already applied to the top-level div in app/layout.tsx, providing a background effect across all pages. There's no need to call it again in page.tsx, and it's best to remove it as it causes unnecessary rendering.

Suggested change
<main>
<Blur />
</main>
<main>
{/* Add the content of this page here. The Blur effect is provided globally from the layout. */}
</main>

@dasosann dasosann closed this Jan 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants