J.P. Morgan · International Private BankJ.P. Morgan · 인터내셔널 프라이빗 뱅크

Design system디자인 시스템

Four products were moving onto one new platform, and we needed a new design system. I built it, built Storybook with the developers, and brought a wrapper system into the scope to keep the products consistent.네 개의 제품이 하나의 새 플랫폼으로 옮겨 가면서 새 디자인 시스템이 필요했어요. 제가 디자인 시스템을 만들고, 개발자들과 Storybook을 만들고, 제품들을 일관되게 유지하기 위해 wrapper 시스템을 범위에 넣었어요.

Role역할Built the design system디자인 시스템 구축
Products제품Payment, Deposit, Asset Transfer, Lending
Built with사용 도구Storybook, VS Code, Copilot
Reconstructed with dummy data. Not J.P. Morgan code.더미 데이터로 재구성했어요. J.P. Morgan 코드가 아니에요.
Before전Same components. Four different sections.같은 컴포넌트, 다른 네 개의 섹션.
Paymentbuilt by hand직접 조립
Client instructions
Type
Email
Received by
C. Surname
Date
04-Jan-2024
Signature check
MatchesNeeds check
Received on DL
Depositbuilt by hand직접 조립
Client instruction
Instruction type
Email
Received by
C. Surname
Signature
MatchesNeeds check
Asset Transferbuilt by hand직접 조립
Instructions
Instruction type
Email
Date
04-Jan-2024
Signature check
MatchesNeeds check
Received on group DL
Lendingbuilt by hand직접 조립
Client instructions
* Type
Email
* Date
04-Jan-2024
* Signature check
MatchesNeeds check
* Cash transfer
YesNo
After후One wrapper. Four identical sections.wrapper 하나, 똑같은 네 개의 섹션.
Payment1 line
ClientInstructionSection
Client instructions
Original client instructions
* Type
Email
* Received by
C. Surname
* Date
04-Jan-2024
* Signature check
MatchesNeeds check
* Cash transfer authorized?
YesNo
Received on group DL
Deposit1 line
ClientInstructionSection
Client instructions
Original client instructions
* Type
Email
* Received by
C. Surname
* Date
04-Jan-2024
* Signature check
MatchesNeeds check
* Cash transfer authorized?
YesNo
Received on group DL
Asset Transfer1 line
ClientInstructionSection
Client instructions
Original client instructions
* Type
Email
* Received by
C. Surname
* Date
04-Jan-2024
* Signature check
MatchesNeeds check
* Cash transfer authorized?
YesNo
Received on group DL
Lending1 line
ClientInstructionSection
Client instructions
Original client instructions
* Type
Email
* Received by
C. Surname
* Date
04-Jan-2024
* Signature check
MatchesNeeds check
* Cash transfer authorized?
YesNo
Received on group DL
14
wrappers built, used across four products개의 wrapper를 만들어 네 제품에서 사용 중
3
versions on the Storybook roadmap단계로 나눈 Storybook 로드맵
1 repo레포 1개
shared with developers. They reviewed my code, I reviewed their build.개발자와 공유. 개발자는 제 코드를, 저는 그들의 빌드를 리뷰했어요.
Roadmap로드맵

Building Storybook in three versions.Storybook을 세 단계로 만들었어요.

Version one was the core components, so developers could build the products in parallel while I built Storybook. Version two was the next most important ones. Version three was the least used components, plus the new ones the products needed.1단계는 핵심 컴포넌트예요. 제가 Storybook을 만드는 동안 개발자들이 제품을 병렬로 만들 수 있게 했어요. 2단계는 그다음으로 중요한 것들, 3단계는 가장 덜 쓰는 컴포넌트와 제품에 새로 필요한 컴포넌트였어요.

V1
Core components핵심 컴포넌트

What every screen needs. Built first, so developers could build products in parallel.모든 화면에 필요한 것. 개발자들이 제품을 병렬로 만들 수 있게 가장 먼저 만들었어요.

ButtonInputSelectRadioCheckboxTable
V2
Next priority다음 우선순위

The next most used components, built on top of the core.그다음으로 많이 쓰는 컴포넌트. 핵심 위에 쌓았어요.

ModalSide panelTabsAccordionToast
V3
Least used + new덜 쓰는 것 + 새것

The rest, plus the new components the products asked for. Wrappers started here.나머지와 제품이 요청한 새 컴포넌트. wrapper는 여기서 시작했어요.

Date pickerFile uploadStepperWrappers
How방법

One shared repo.하나의 공유 레포.

It was my first time building Storybook, so I asked the developers to set it up and build one input field the way they would use it. I built the rest from that format. Developers built the complex ones, like tables.Storybook을 처음 만드는 거라, 개발자들에게 세팅과 함께 입력 필드 하나를 그들이 실제로 쓸 방식대로 만들어 달라고 했어요. 나머지는 그 형식을 따라 제가 만들었어요. 테이블처럼 복잡한 건 개발자들이 만들었어요.

Before every push, they reviewed my code, and I reviewed their build for design and interaction.푸시하기 전마다 개발자는 제 코드를 리뷰하고, 저는 그들의 빌드를 디자인과 인터랙션 관점에서 리뷰했어요.

Developers개발자

Set up StorybookStorybook 세팅

The structure, and how each component is shown.구조와 각 컴포넌트를 보여주는 방식.

→
Developers개발자

One input field입력 필드 하나

Built the way they would use it. The format to follow.실제로 쓸 방식대로. 따라 할 형식.

→
Me나

The rest of the components나머지 컴포넌트

Built from that format, accessible by standard.그 형식으로, 접근성 기준에 맞게.

→
Developers개발자

The complex ones복잡한 것들

Tables, and anything we agreed was complex.테이블, 그리고 복잡하다고 합의한 것.

→
Both함께

Review every push푸시마다 리뷰

They review my code. I review their build for design and interaction.개발자는 제 코드를, 저는 빌드의 디자인과 인터랙션을.

The problem문제

The same section looked different in every product.같은 섹션이 제품마다 다르게 보였어요.

During version three, I ran design QA for all four products. The components were used well, but a section shared by all four, the client instructions, looked different in each one. The text, spacing, size, and layout were all off.3단계에서 네 제품의 디자인 QA를 했어요. 컴포넌트는 잘 쓰이고 있었지만, 네 제품이 모두 쓰는 고객 지시 섹션이 제품마다 달랐어요. 글자, 간격, 크기, 레이아웃이 전부 어긋나 있었어요.

The idea아이디어

Why can’t one person build it once, and everyone reuse it?한 사람이 한 번 만들고, 모두가 다시 쓰면 안 될까?

That became the wrapper. A wrapper locks a whole section into one file in Storybook: the components, the rows, and the spacing. Developers bring in the whole prebuilt Lego piece with one line of code. I validated the idea with the developers before taking it further.그게 wrapper가 됐어요. wrapper는 섹션 전체를 Storybook의 파일 하나에 고정해요. 컴포넌트, 줄, 간격까지요. 개발자는 코드 한 줄로 미리 만들어진 레고 조각 전체를 가져와요. 더 진행하기 전에 개발자들과 먼저 검증했어요.

Before and after.전과 후.

Same components, four different sections. Then one wrapper, four identical sections.같은 컴포넌트, 다른 네 개의 섹션. 그리고 wrapper 하나로 똑같은 네 개의 섹션.

Before전
Each product assembles it제품마다 직접 조립
One of four product files네 개의 제품 파일 중 하나
import { Select, TextField, RadioGroup } from '@ds/components' <h3>Instructions</h3> // title picked by this team <Select label="Instruction type" /> <TextField label="Date" /> <RadioGroup label="Signature" /> <style> .field { margin-bottom: 8px } // spacing picked here </style>
  • Components are consistent. The section around them is not.컴포넌트는 일관돼요. 그걸 감싼 섹션은 아니에요.
  • Title, order, and spacing written four times, by four teams.제목, 순서, 간격을 네 팀이 네 번 써요.
After후
One wrapper, reusedwrapper 하나를 재사용
The pattern lives in one file패턴은 파일 하나에
// ClientInstructionSection.svelte, one file in Storybook <section> <h3>Client instructions</h3> <div class="row"> type · received by · date </div> <div class="row"> signature · cash transfer </div> </section> <style> .row { gap: 24px } </style> // every product file now <ClientInstructionSection />
  • Defined once. Products can’t override it.한 번 정의. 제품이 덮어쓸 수 없어요.
  • Change the file once, all four update.파일을 한 번 고치면 네 곳이 바뀌어요.
Scope범위

Getting it built with limited developer time.부족한 개발 리소스로 만들기.

The tech lead agreed it would help. I showed product the sections that looked different and got buy-in. Developer time was limited, so we agreed who builds what: developers take the complex wrappers, I take the simple ones. They built the first one as the example, and I’ve built the rest with AI, reviewing the code with them.테크 리드가 도움이 될 거라고 동의했어요. 프로덕트에 서로 달라 보이는 섹션들을 보여주고 동의를 얻었어요. 개발 리소스가 부족해서 누가 무엇을 만들지 정했어요. 복잡한 wrapper는 개발자가, 단순한 건 제가 맡았어요. 개발자들이 첫 번째를 예시로 만들었고, 나머지는 제가 AI로 만들고 함께 코드를 리뷰했어요.

Me + tech lead나 + 테크 리드

Can it be built?만들 수 있을까?

The tech lead agreed it would help developers.테크 리드가 개발자에게 도움이 된다고 동의.

→
Me + product나 + 프로덕트

Into scope범위에 넣기

I showed the sections that didn’t match. Product bought in.안 맞는 섹션을 보여주고 프로덕트 동의를 얻었어요.

→
Developers개발자

The first wrapper첫 wrapper

Built in their standard, as the example to follow.그들의 기준으로, 따라 할 예시로.

→
Both함께

Who builds what누가 무엇을

Complex ones by developers. Simple ones by me, with AI, code reviewed together.복잡한 건 개발자가. 단순한 건 제가 AI로, 코드는 함께 리뷰.

Impact임팩트

One code to copy. One holistic product.복사할 코드 하나. 하나로 보이는 제품.

Developers copy one code instead of building the same section four times. Shared sections look the same everywhere. And a fix happens once, in Storybook, and applies to every product and workflow.개발자는 같은 섹션을 네 번 만드는 대신 코드 하나를 복사해요. 공유 섹션은 어디서나 똑같이 보여요. 수정은 Storybook에서 한 번만 하면 모든 제품과 워크플로우에 적용돼요.

Next, designers request a wrapper, a skill drafts it from the developers’ example, we review it, and publish. A designer adds to the design system without a developer ticket.다음 단계는 디자이너가 wrapper를 요청하면, 스킬이 개발자의 예시를 바탕으로 초안을 만들고, 함께 리뷰해서 게시하는 거예요. 디자이너가 개발 티켓 없이 디자인 시스템에 기여할 수 있어요.

Designer디자이너

Request요청

Names the section and the pattern it needs. No developer ticket.필요한 섹션과 패턴을 적어요. 개발 티켓 없이.

→
AI skillAI 스킬

Draft초안

A skill drafts the wrapper from the developers’ example.스킬이 개발자의 예시로 wrapper 초안을 만들어요.

→
Me + developer나 + 개발자

Review리뷰

I check design and interaction. A developer checks the code.저는 디자인과 인터랙션을, 개발자는 코드를.

→
StorybookStorybook

Publish게시

Every product uses it with one line.모든 제품이 한 줄로 써요.

Try the Storybook.Storybook을 써 보세요.

Foundations, components, and wrapper stories, rebuilt with dummy data.파운데이션, 컴포넌트, wrapper 스토리를 더미 데이터로 다시 만들었어요.

Storybook prototypeStorybook 프로토타입Open full screen ↗전체 화면으로 열기 ↗

More work다른 작업