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
Trong thư mục dự án React của bạn, cài gói tldraw bằng npm.
npm i tldrawTrong 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.
import { Tldraw } from 'tldraw' import 'tldraw/tldraw.css' export default function App() { return ( <div style={{ position: 'fixed', inset: 0 }}> <Tldraw /> </div> ) }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
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.
npx create-tldraw@latestCá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
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.
npm i -g corepackTả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.
git clone https://github.com/tldraw/tldraw.git cd tldraw pnpm install pnpm dev
Dùng thử lần đầu
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.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.
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ú.
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.
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.
git clone https://github.com/tldraw/tldraw.gitRepo tương tự nên xem
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
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