Skip to Content

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

App 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ùng app/db thế nào.
  • check chặt chẽ. Lỗi nào agent hay mắc đều thành một quy tắc trong check, ví dụ dùng prop visible mà 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 được import "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ị check chặ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

Cập nhật