Dữ liệu FDE TimesViệc làm FDE đang mở 873▼9 Thay đổi số việc đang mở trong 7 ngày, so sánh cùng phạm vi: không tính việc của các công ty mới được theo dõi tuần nàyMới trong 7 ngày 55Công ty đang tuyển 181Nhận làm từ xa 25%Lương trung vị (Mỹ) $200kTuyển nhiều nhất Databricks 98
中文EN

Tờ báo của nghề Forward Deployed Engineer

Công cụ

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.

Chia sẻLinkedInFacebookX

Tóm tắt nhanh

  • shadcn/ui không phải thư viện để cài: CLI chép code component vào repo, và bạn sửa thẳng trên đó
  • Sidebar có sẵn, còn Data Table thì bạn phải tự ghép trên TanStack Table theo hướng dẫn
  • Code là của bạn thì bản vá cũng là việc của bạn: không có cập nhật tự động, chạy lại generator sẽ ghi đè file
Sơ đồ: CLI shadcn chép code component vào repo của bạn. Lớp components/ui (button, sidebar, table) được tô cam, sửa trực tiếp được. Lớp này import các package Radix trong node_modules, vẫn là dependency như thường. Ô cảnh báo màu đỏ: chạy lại CLI sẽ ghi đè phần đã sửa.
shadcn/ui chép code component vào repo, nên bạn sửa trực tiếp được lớp trên cùng. Các package Radix bên dưới vẫn nằm trong node_modules, và chạy lại lệnh generator sẽ ghi đè phần đã chỉnh. Nguồn: tài liệu shadcn/ui, Vercel Academy, PkgPulse.

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.

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:

// 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.

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.

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:

// 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>
    ),
  },
]
// 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.

Bài này có hữu ích không?

Dùng cùng trợ lý AIHỏi Claude ↗Hỏi ChatGPT ↗
10 nguồn
Đọc tiếp trên lộ trình · Chặng 2: Kỹ thuật rộngAWS CDK giúp FDE dựng lại hạ tầng cho từng khách mà không chép tayCái bẫy thường nằm ở một tên bucket viết cứng hoặc một construct bị đổi tên.