# Vì sao FDE nên sở hữu code giao diện thay vì cài thư viện UI

> shadcn/ui chép component thẳng vào repo của bạn, nên màn hình quản trị sửa được theo ý khách mà không phải chờ ai.

Bản gốc: https://fdetimes.net/vi/cong-cu/shadcn-ui-tailwind-giao-dien-admin-demo-cho-khach/

Thử hình dung thế này. Thứ Hai bạn gặp khách, thứ Sáu phải demo một agent xử lý đơn hàng. Agent chạy rồi, nhưng người vận hành bên khách cần một màn hình để duyệt kết quả, mà dự án không có designer.

Khi đó, công cụ phù hợp là thứ cho bạn sửa từng dòng giao diện ngay trong repo. Một thư viện UI đẹp nhưng đóng kín, muốn đổi gì cũng phải lách quanh nó, sẽ làm bạn chậm đúng vào tuần cần nhanh nhất.

shadcn/ui đi theo hướng đó. Repo trên GitHub mô tả đây là các component ghép được và có hỗ trợ accessibility. Tài liệu chính thức còn nói rõ đây không phải component library, mà là cách để bạn tự dựng component library của mình.

Với FDE, khác biệt này không chỉ là chuyện chữ nghĩa. Bản demo nào cũng đến lúc khách muốn chỉnh một chi tiết nhỏ. Lúc đó, sửa ngay trong file của mình nhanh hơn nhiều so với tìm cách can thiệp vào một package do người khác quản lý.

## Code component nằm trong repo của bạn

Dự án gọi nguyên tắc này là Open Code. Tài liệu nói thẳng: lớp trên cùng của code component là phần bạn được sửa trực tiếp, và muốn đổi nút bấm thì bạn mở code nút bấm ra sửa. Khi khách muốn cột trạng thái hiện badge đỏ cho đơn trễ hạn, bạn không phải override style của người khác, cũng không phải chờ ai trả lời issue.

Vercel Academy tóm điều này gọn: thư viện truyền thống tạo quan hệ phụ thuộc, còn shadcn/ui tạo quan hệ sở hữu. Phần style dựa trên Tailwind CSS. Bản v4.0 ra ngày 22/1/2025, và thay đổi lớn nhất là cấu hình dự án chuyển từ JavaScript sang CSS.

## Bản demo màn hình duyệt đơn, làm từng bước

Quay lại ví dụ màn hình duyệt đơn, giả sử bạn bắt đầu từ một dự án Vite dùng React và TypeScript. Tailwind v4 với Vite cần hai thứ: plugin `@tailwindcss/vite` và một dòng import trong file CSS. Lệnh `add` của CLI shadcn sau đó thêm component cùng dependency của nó vào dự án.

```bash
npm install tailwindcss @tailwindcss/vite
npm install -D @types/node   # để vite.config dùng được module path
# trong src/index.css, thay toàn bộ nội dung bằng: @import "tailwindcss";
```

Cài package thôi chưa đủ, plugin phải được đăng ký trong `vite.config.ts`. Cùng lúc đó, nên khai báo luôn alias `@` trỏ về thư mục `src`, vì code component sẽ import theo kiểu `@/components/ui/button`:

```ts
// vite.config.ts
import path from "path"
import react from "@vitejs/plugin-react"
import tailwindcss from "@tailwindcss/vite"
import { defineConfig } from "vite"

export default defineConfig({
  plugins: [react(), tailwindcss()],
  resolve: { alias: { "@": path.resolve(__dirname, "./src") } },
})
```

TypeScript cũng phải hiểu alias đó. Trong `tsconfig.json`, và cả `tsconfig.app.json` nếu template của bạn tách file, thêm vào `compilerOptions` hai dòng `"baseUrl": "."` và `"paths": { "@/*": ["./src/*"] }`. Thiếu bước này, `init` khó chạy trơn và import `@/...` sẽ báo lỗi, một chỗ kẹt rất dễ gặp khi làm vội.

```bash
npx shadcn@latest init
npx shadcn@latest add sidebar table button
npm install @tanstack/react-table
```

Vì Tailwind v4 cấu hình bằng CSS, chỗ đổi màu theo thương hiệu của khách nằm trong file CSS chứ không phải file JavaScript. Đổi được nhanh là đáng giá. Lãnh đạo bên khách thấy màu thương hiệu của chính họ trên màn hình thì dễ hình dung công cụ này đã thuộc về công ty mình, thay vì một bản mẫu của bên ngoài.

Còn `add sidebar` cho bạn thanh điều hướng mà tài liệu mô tả là ghép được, đổi theme được và tùy biến được: menu bên trái, nội dung bên phải, khung quen thuộc của mọi trang quản trị.

Phần tốn công nhất là bảng đơn hàng. Data Table của shadcn/ui không phải một bảng đóng gói sẵn. Thay vì phát hành component, tài liệu đưa ra một hướng dẫn để bạn tự ghép bảng trên TanStack Table.

**Điểm mấu chốt:** Với bản demo, quyền sửa từng dòng code giao diện quý hơn một thư viện đẹp.

Cách ghép bảng như vậy lại hợp với công việc ở chỗ khách. Giả sử bạn có 200 đơn mà agent đã xử lý. Người vận hành chỉ cần lọc theo trạng thái cần duyệt, sort theo ngày tạo để thấy đơn cũ nhất trước, và bấm vào một dòng để xem agent đã quyết định gì.

Bạn định nghĩa đúng các cột đó và gắn đúng một kiểu sort, một kiểu lọc, không hơn. Đoạn dưới là phác thảo tối thiểu, đã có đủ import; phần render bảng bằng các component `Table` bạn ghép thêm theo hướng dẫn:

```tsx
// columns.tsx
import { ColumnDef } from "@tanstack/react-table"
import { Button } from "@/components/ui/button"

export type Order = { id: string; status: "can_duyet" | "da_duyet"; createdAt: string }

export const columns: ColumnDef<Order>[] = [
  { accessorKey: "id", header: "Mã đơn" },
  { accessorKey: "status", header: "Trạng thái" },
  {
    accessorKey: "createdAt",
    header: ({ column }) => (
      <Button variant="ghost"
        onClick={() => column.toggleSorting(column.getIsSorted() === "asc")}>
        Ngày tạo
      </Button>
    ),
  },
]
```

```tsx
// data-table.tsx (phác thảo: phần JSX render bảng lược bớt)
import { useState } from "react"
import {
  useReactTable,
  getCoreRowModel,
  getSortedRowModel,
  getFilteredRowModel,
  SortingState,
  ColumnFiltersState,
} from "@tanstack/react-table"
import { columns, Order } from "./columns"

export function OrdersTable({ data }: { data: Order[] }) {
  const [sorting, setSorting] = useState<SortingState>([])
  const [columnFilters, setColumnFilters] = useState<ColumnFiltersState>([])

  const table = useReactTable({
    data, columns,
    getCoreRowModel: getCoreRowModel(),
    getSortedRowModel: getSortedRowModel(),
    getFilteredRowModel: getFilteredRowModel(),
    onSortingChange: setSorting,
    onColumnFiltersChange: setColumnFilters,
    state: { sorting, columnFilters },
  })
  // nút "Cần duyệt": table.getColumn("status")?.setFilterValue("can_duyet")
  // ...render table.getHeaderGroups() và table.getRowModel().rows
}
```

## Cái giá của việc tự sở hữu code

Mặt trái nằm ngay trong ưu điểm. Vercel Academy nêu rõ cái giá phải trả: bạn mất cập nhật tự động và bản vá bảo mật tự động. Theo PkgPulse, muốn cập nhật thì bạn chạy lại lệnh generator cho component, và lệnh đó ghi đè file, nên mọi chỉnh sửa của bạn có thể mất nếu không đối chiếu trước.

Cũng đừng nghĩ mình sở hữu tất cả. PkgPulse lưu ý component đã chép vẫn dựa vào các package Radix trong node_modules. Phần bạn giữ là lớp trên cùng, còn tầng bên dưới vẫn là dependency như thường.

Accessibility cũng cần để ý. Component ban đầu được làm có tính đến accessibility, nhưng khi bạn sửa markup để chiều khách thì không ai kiểm lại giúp bạn. Với demo thì chấp nhận được; nếu màn hình đó sắp thành công cụ nội bộ chạy thật, hãy bàn với khách ai sẽ giữ phần code giao diện trước khi bàn giao.

Hệ sinh thái vẫn đang thay đổi. Changelog tháng 8/2026 ghi GitHub registry giờ chạy được với repo private, nghĩa là một đội có thể gom component nội bộ đã chỉnh vào một nơi riêng. Với khách có nhiều dự án, đó là chỗ đáng gợi ý khi bàn giao.

Giới hạn cuối cùng là Data Table. Vì bạn phải tự ghép, nên nếu chưa quen TanStack Table thì đây là chỗ bạn mất thời gian nhiều nhất. Nên học trước khi có hợp đồng, đừng để đến tối thứ Năm mới học.

## Nên học gì trước, và đưa vào CV thế nào

Thứ tự hợp lý là Tailwind trước, vì component dựng trên nó, kèm cách cấu hình plugin và alias trong Vite. Sau đó học hai lệnh `init` và `add`, rồi dành phần lớn thời gian cho TanStack Table, phần duy nhất bạn phải hiểu kỹ chứ không thể chỉ chép về rồi dùng.

Về nghề nghiệp, một màn hình quản trị chạy được là thứ nhà tuyển dụng có thể tự bấm thử, rõ hơn mọi dòng mô tả kỹ năng. Đừng ghi chung chung "biết React" trong CV. Hãy viết kiểu "dựng giao diện duyệt kết quả agent, có sort và lọc theo dữ liệu thật", rồi gắn link repo.

Bạn không cần là designer. Điều đáng chứng minh là khi khách hỏi "cho tôi xem được không", bạn mở được một màn hình cho họ xem ngay.

**Thử ngay tuần này:**

- Tạo một dự án Vite React mới, cài tailwindcss và @tailwindcss/vite, đăng ký plugin và alias @ trong vite.config cùng tsconfig, rồi chạy init và add sidebar
- Lấy một file CSV công khai khoảng vài trăm dòng, ghép Data Table có sort theo ngày và lọc theo trạng thái, rồi đưa repo lên GitHub làm portfolio
- Đổi màu theme trong file CSS sang màu thương hiệu của một công ty bất kỳ để tập đổi giao diện theo khách

## Nguồn

- [Introduction - shadcn/ui](https://ui.shadcn.com/docs)

- [shadcn - shadcn/ui](https://ui.shadcn.com/docs/cli)

- [GitHub - shadcn-ui/ui: Composable, accessible components with thoughtful defaults.](https://github.com/shadcn-ui/ui)

- [Data Table](https://ui.shadcn.com/docs/components/data-table)

- [Sidebar - shadcn/ui](https://ui.shadcn.com/docs/components/sidebar)

- [Changelog - shadcn/ui](https://ui.shadcn.com/docs/changelog)

- [Tailwind CSS v4.0 - Tailwind CSS](https://tailwindcss.com/blog/tailwindcss-v4)

- [Installing Tailwind CSS with Vite - Tailwind CSS](https://tailwindcss.com/docs/installation)

- [Why shadcn/ui is Different (Vercel Academy)](https://vercel.com/academy/shadcn-ui/why-shadcn-ui-is-different)

- [shadcn/ui vs Radix UI: Component Library vs 2026 (PkgPulse Guides)](https://www.pkgpulse.com/guides/shadcn-ui-vs-radix-ui-component-library)
