Vì sao stack cố định
Mọi app trên manh.run dùng chung một stack: antd và pro-components cho giao diện, Hono, Drizzle và SQLite cho API. Nhờ vậy agent viết đúng hơn, màn hình trông như sản phẩm thật và các dịch vụ có sẵn dùng được ngay mà không phải cài. Bạn không đổi được stack này.
Stack gồm những gì
Giao diện (.tsx, trong trình duyệt)
antd · @ant-design/pro-components · @ant-design/x · @ant-design/charts · @ant-design/graphs
thêm: @xyflow/react · @dnd-kit · @monaco-editor/react · axios · dayjs
Tailwind: chỉ class tiện ích trong className
API (.ts, trên server)
Hono 4 · @hono/zod-openapi · Zod · Drizzle ORM
Database
SQLite — mỗi app một database riêng
Có sẵn
manh/email · manh/openai · manh/blob · file .cron.tsApp không dùng shadcn, MUI, styled-components hay file CSS, và không có database nào khác ngoài SQLite của app.
Agent viết đúng hơn trên một stack
Agent viết code tốt nhất khi chỉ có một cách đúng và cách đó được ghi rõ. Khi stack cố định, manh.run làm được ba việc mà nếu cho chọn stack tuỳ ý thì không làm được:
- Tài liệu đi sâu thay vì dàn trải. App nào agent cũng đọc cùng một bộ tài liệu: dùng prop nào của
ProTable, viết handler ra sao, dùngapp/dbthế nào. checkchặt chẽ. Lỗi nào agent hay mắc đều thành một quy tắc trongcheck, ví dụ dùng propvisiblemà antd v6 đã bỏ, hay import từdrizzle-orm/sqlite-core. Lỗi bị chặn trước khi tới app thật.- Sửa một lần cho mọi app. Khi manh.run phát hiện một kiểu lỗi mới, quy tắc mới áp dụng ngay cho mọi project.
Màn hình như sản phẩm thật
App nội bộ chủ yếu gồm danh sách, form, trang chi tiết và dashboard. @ant-design/pro-components có sẵn những màn hình đó với chất lượng như sản phẩm thật. ProTable có tìm kiếm, phân trang, chọn nhiều dòng. ProForm có bố cục, kiểm tra dữ liệu và form nhiều bước. ProLayout có menu và khung trang.
Agent chỉ khai báo cột và cách tải dữ liệu, không phải dựng lại bảng hay form từ div. Vì vậy các app có giao diện và cách dùng giống nhau.
Dịch vụ có sẵn trên cùng một nền tảng
Mọi app chạy trên cùng nền tảng của manh.run, nên các dịch vụ dưới đây có sẵn, bạn không phải đăng ký hay cấu hình gì:
- Email gửi đi qua
manh/email. - AI qua
manh/openai, không cần API key. - Kho file qua
manh/blob. - Việc chạy định kỳ bằng file
*.cron.ts. - Quay lại bản cũ: code có checkpoint, quay lại bản trước chỉ mất vài giây.
Giao diện và API deploy cùng nhau trên một địa chỉ <id>.manh.run, nên bạn không phải cấu hình CORS hay thuê hai nơi host.
Giới hạn của stack
Tính năng nào không làm được bằng stack này thì manh.run không làm. Ví dụ:
- Không dùng được UI kit khác, Vue hay file CSS riêng.
- Đăng nhập chỉ có email/mật khẩu và Google (bật trong
app/auth.ts). Chưa có GitHub hay nhà cung cấp OAuth khác. - Không dùng được package cần hệ thống file, tiến trình con hay thư viện native trên server.
- Không dùng được database khác làm nơi lưu chính, dữ liệu nằm trong SQLite của app. Gọi API bên ngoài thì vẫn được.
Nếu app của bạn cần những thứ trên, manh.run không phải lựa chọn phù hợp. Giữ stack cố định là quyết định lâu dài, không phải giới hạn tạm thời.
Cần biết
- Được dùng class Tailwind trong
className, nhưng không đượcimport "tailwindcss"hay dùng UI kit dựa trên Tailwind. - Code server chỉ import được package có trong danh sách của manh.run. Package ngoài danh sách sẽ bị
checkchặn hoặc cảnh báo. - Màu và bo góc lấy từ token antd (
theme.useToken()hoặc class nhưbg-surface), để giao diện tự theo chế độ tối và màu thương hiệu.
Bước tiếp theo
- manh.run hoạt động thế nào — đường đi từ cây
app/đến app chạy thật. - Quy tắc check — các quy tắc giữ code nằm trong stack.
- Email, AI, kho file — cách dùng các dịch vụ có sẵn.