Chuyển đến nội dung

tldraw / tldraw

tldraw

Bộ công cụ để lập trình viên nhúng bảng trắng vô hạn kiểu Miro vào ứng dụng React

tldraw là một thư viện (SDK) giúp lập trình viên gắn một tấm bảng vẽ vô hạn vào trang web hay ứng dụng React của mình: vẽ tay, hình khối, mũi tên, ghi chú, cộng tác thời gian thực. Đây không phải phần mềm cài về rồi dùng ngay; nó là nguyên liệu để dựng ra ứng dụng bảng trắng riêng. Lưu ý giấy phép: dùng thử khi phát triển thì miễn phí, nhưng đưa lên môi trường thật cần mua khoá license.

  • 51.429 sao
  • 3.607 fork
  • TypeScript
  • Cập nhật hôm nay
  • Giấy phép riêng, xem trên GitHub
Độ khó
Khó Dành cho người biết lập trình
Dạng
Thư viện lập trình
Chạy trên
Web, Node.js
Chi phí
Miễn phí, có bản trả phí

Trải nghiệm khi dùng tldraw

Với lập trình viên, hành trình bắt đầu rất ngắn. Bạn cài gói tldraw bằng npm, thêm một thành phần Tldraw vào trang React, và trình duyệt hiện ra một tấm bảng trắng rộng vô tận: kéo chuột để vẽ, thả hình chữ nhật, hình tròn, mũi tên, gõ chữ, dán ảnh. Bạn cuộn và phóng to thoải mái như dùng Miro hay FigJam, nhưng tấm bảng này nằm ngay trong sản phẩm của bạn.

Phần hay nhất nằm ở chỗ nó mở cho bạn tuỳ biến. README nói bạn có thể tạo hình khối riêng, công cụ riêng, thay giao diện và điều khiển bảng bằng mã lập trình. Muốn nhanh hơn thì chạy lệnh tạo dự án mẫu (starter kit): có sẵn mẫu cộng tác nhiều người, mẫu cho AI đọc và chỉnh sửa nội dung trên bảng, mẫu kéo thả các khối để tạo quy trình tự động hoá.

Nếu bạn không phải lập trình viên, hãy hiểu tldraw như động cơ nằm bên trong nhiều ứng dụng bảng trắng. Bạn sẽ không mở repo này để vẽ sơ đồ cho buổi họp; nhưng nếu công ty có người làm web, đây là lựa chọn để họ dựng công cụ vẽ sơ đồ nội bộ thay vì viết từ đầu.

Tính năng nổi bật

Bảng vẽ vô hạn chạy trên trình duyệt

Vẽ tay có nhận lực nhấn bút, hình học, mũi tên bám theo hình, chèn ảnh và video, xuất ra ảnh. Chạy được trên máy tính, màn hình cảm ứng và điện thoại.

Cộng tác thời gian thực

Gói đồng bộ @tldraw/sync cho phép nhiều người cùng vẽ trên một bảng và bạn có thể tự cài máy chủ cho phần này.

Tuỳ biến sâu

Tự tạo hình khối, công cụ, thành phần giao diện và hành vi mới. Có API để điều khiển bảng bằng mã khi chương trình đang chạy.

Nhúng được cả trang web khác

Bảng hỗ trợ nhúng nội dung như YouTube, Figma, GitHub ngay trên canvas, nên dễ làm bảng tổng hợp tư liệu.

Mẫu khởi đầu cho ứng dụng AI

Có starter kit cho trò chuyện AI trên canvas, agent AI chỉnh bảng, trình dựng workflow và chuỗi xử lý ảnh. Bạn lấy về làm nền rồi sửa.

Tài liệu thân thiện với trợ lý lập trình

Trang tài liệu có tệp llms.txt để công cụ AI đọc, và các gói mới còn kèm tệp tài liệu ngay trong thư mục cài đặt.

Tận dụng tldraw vào việc gì?

Lập trình viên web

Công cụ vẽ sơ đồ trong phần mềm quản lý nội bộ

Cho nhân viên vẽ quy trình, sơ đồ tổ chức ngay trong hệ thống công ty mà không phải mở app ngoài.

Đội làm edtech, giáo viên có người hỗ trợ kỹ thuật

Bảng trắng cho lớp học trực tuyến

Giáo viên và học sinh cùng viết, vẽ lên một bảng chung trong trang lớp học của riêng mình.

Lập trình viên, người làm sản phẩm AI

Ứng dụng AI có giao diện kéo thả

Dùng mẫu workflow hoặc agent để thử nhanh một ý tưởng công cụ AI cho người dùng trực quan hơn khung chat.

Đội làm sản phẩm

Tính năng ghi chú trên ảnh hoặc bản thiết kế

Cho khách hàng khoanh tròn, vẽ mũi tên lên ảnh mẫu thiết kế để góp ý, rồi lưu lại.

Cần chuẩn bị gì?

  • Biết dùng React và npm; Node.js phiên bản 20 trở lên nếu chạy mã nguồn của repo theo README.
  • Trình duyệt hiện đại; README nói chạy được trên máy tính, tablet và điện thoại.
  • Nếu đưa vào sản phẩm thật: cần mua license key theo trang giá của tldraw.
  • Phần cộng tác thời gian thực theo mẫu chính thức dùng Cloudflare Durable Objects, nghĩa là cần tài khoản dịch vụ này nếu đi đúng mẫu.

Hướng dẫn cài đặt chi tiết

Cài trên Thêm vào dự án React

  1. Trong thư mục dự án React của bạn, cài gói tldraw bằng npm.

    Terminal
    npm i tldraw
  2. Trong tệp giao diện chính, nhập thành phần Tldraw và tệp CSS đi kèm rồi đặt vào trang. Bọc ngoài bằng một thẻ có kích thước rõ ràng (ví dụ phủ kín màn hình, như dưới), vì bảng sẽ lấp đầy khung chứa nó. Không có chỗ nào bạn phải điền thêm.

    JavaScript
    import { Tldraw } from 'tldraw'
    import 'tldraw/tldraw.css'
    
    export default function App() {
      return (
        <div style={{ position: 'fixed', inset: 0 }}>
          <Tldraw />
        </div>
      )
    }
  3. Chạy dự án như bình thường và mở trình duyệt vào địa chỉ mà công cụ dev của bạn in ra.

Cài trên Dùng starter kit

  1. Muốn có sẵn một ứng dụng mẫu (cộng tác, agent AI, workflow...), chạy lệnh tạo dự án chính thức của tldraw rồi chọn mẫu bạn cần theo hướng dẫn hiện ra.

    Terminal
    npx create-tldraw@latest
  2. Các starter kit theo README dùng giấy phép MIT riêng, nên bạn có thể sửa thoải mái; riêng phần SDK tldraw bên dưới vẫn theo giấy phép tldraw.

Cài trên Chạy mã nguồn repo

  1. Cài Node.js 20 trở lên, rồi bật corepack để dùng đúng phiên bản pnpm mà repo yêu cầu.

    Terminal
    npm i -g corepack
  2. Tải mã nguồn, cài thư viện và chạy máy chủ phát triển. README nói trang ví dụ sẽ chạy ở localhost cổng 5420.

    Terminal
    git clone https://github.com/tldraw/tldraw.git
    cd tldraw
    pnpm install
    pnpm dev

Dùng thử lần đầu

  1. Sau khi thêm thành phần Tldraw, mở trang. Bạn sẽ thấy bảng trắng cùng thanh công cụ; thử chọn công cụ vẽ tay và vẽ vài nét.

  2. Thả một hình chữ nhật, một hình tròn rồi nối chúng bằng mũi tên. Kéo hình đi chỗ khác để thấy mũi tên bám theo.

  3. Dán một bức ảnh từ clipboard hoặc kéo ảnh vào, rồi dùng công cụ vẽ khoanh vào một vùng để ghi chú.

  4. Vào trang tldraw.dev/docs, mở mục ví dụ (examples) và thử tạo một hình khối tuỳ biến đầu tiên để thấy mức độ mở rộng của SDK.

  5. Khi sẵn sàng làm sản phẩm thật, đọc kỹ trang giá và giấy phép của tldraw trước khi đưa lên môi trường chạy thật.

Mẹo dùng hay

  • Bắt đầu từ starter kit gần với ý tưởng của bạn nhất thay vì viết từ số không; sửa mẫu nhanh hơn nhiều.
  • Nếu dùng trợ lý lập trình AI, đưa cho nó tệp llms.txt của tldraw để nó viết mã đúng với API hiện tại.
  • Bảng nên nằm trong khung có chiều cao cố định; nếu thấy bảng trống hoặc cao bằng 0, hãy kiểm tra lại kích thước thẻ bao ngoài.

Lưu ý và hạn chế

  • Giấy phép tldraw không phải MIT hay Apache: dùng khi phát triển thì được, nhưng chạy thật ở môi trường production cần license key trả phí theo README. Đọc kỹ trước khi dựng sản phẩm thương mại.
  • Đây là thư viện cho lập trình viên React, không phải ứng dụng bảng trắng cài sẵn dành cho người dùng thường.
  • README cho biết dự án hiện chưa nhận đóng góp mã từ bên ngoài, chỉ nhận báo lỗi và đề xuất tính năng.

Câu hỏi thường gặp

tldraw có miễn phí không?

Dùng trong lúc phát triển thì miễn phí. Khi chạy ở môi trường thật cho người dùng, README yêu cầu có license key và dẫn tới trang giá. Các starter kit thì theo giấy phép MIT riêng.

Tôi không biết lập trình thì dùng được không?

Repo này thì không phù hợp vì nó là bộ công cụ để lập trình. Bạn có thể nhờ người làm web dựng giúp, hoặc tìm một ứng dụng bảng trắng có sẵn để dùng ngay.

Có hỗ trợ tiếng Việt không?

README không nói về danh sách ngôn ngữ giao diện. Phần chữ trên bảng thì nhận văn bản bình thường nên bạn gõ tiếng Việt được; còn bộ chuỗi giao diện, hãy xem tài liệu trên tldraw.dev.

Tải mã nguồn về máy

Nếu bạn muốn xem hoặc sửa mã nguồn, mở Terminal (trên Windows là PowerShell) và chạy lệnh dưới. Máy cần cài sẵn Git.

Terminal
git clone https://github.com/tldraw/tldraw.git

Repo tương tự nên xem

Năng suất & ghi chú136K

Excalidraw

excalidraw / excalidraw

Bảng trắng vẽ sơ đồ phong cách nét vẽ tay, dùng ngay trên trình duyệt, miễn phí và có thể cộng tác trực tiếp

DễWebNode.js
Năng suất & ghi chú64K

draw.io Desktop

jgraph / drawio-desktop

Bản ứng dụng máy tính của draw.io (diagrams.net) để vẽ sơ đồ, lưu file ngay trên máy và dùng không cần mạng

DễWindowsmacOSLinux

Nội dung được biên soạn bằng tiếng Việt dựa trên tài liệu chính thức của dự án, cập nhật lần cuối 16/11/2026. Lệnh cài có thể thay đổi theo phiên bản mới; nếu có khác biệt, hãy làm theo README trên GitHub.

Cùng chủ đề: Năng suất & ghi chú

Năng suất & ghi chú80,8K

Hoppscotch

hoppscotch / hoppscotch

Công cụ gửi và kiểm thử API ngay trên trình duyệt, nhẹ hơn Postman và có thể tự cài trên máy chủ riêng

VừaWebWindowsmacOSLinux+1
Năng suất & ghi chú79K

AppFlowy

AppFlowy-IO / AppFlowy

Không gian làm việc kiểu Notion mã nguồn mở: ghi chú, tài liệu, bảng dữ liệu, bạn giữ quyền với dữ liệu

DễWindowsmacOSLinuxAndroid+1
Năng suất & ghi chú74,6K

AFFiNE

toeverything / AFFiNE

Không gian làm việc gộp tài liệu, bảng trắng và bảng dữ liệu, ưu tiên lưu trên máy và có thể tự cài

VừaWindowsmacOSLinuxWeb+1
Năng suất & ghi chú65,5K

NocoDB

nocodb / nocodb

Biến cơ sở dữ liệu thành bảng tính kiểu Airtable: xem, lọc, nhập liệu và chia sẻ mà không cần viết code

VừaDockerWeb
Năng suất & ghi chú64,5K

Memos

usememos / memos

Sổ ghi chú nhanh tự cài trên máy chủ của bạn, ghi chú theo dòng thời gian, hỗ trợ Markdown và thẻ

VừaDockerWebLinuxmacOS+1
Năng suất & ghi chú64,1K

MarkText

marktext / marktext

Trình soạn thảo Markdown đơn giản, xem trước ngay khi gõ, miễn phí cho Windows, macOS và Linux

DễWindowsmacOSLinux

Xem cả 18 repo Năng suất & ghi chú Về Kho Repo