SSATATECH PLAYGROUND
Southern Alliance of Technology Association
SÀI GÒNMEKONG DELTASOUTH CENTRAL

NGHĨ THẬT.
LÀM THẬT.
NÓI BẰNG SẢN PHẨM.

SATA Tech Playground là nơi ý tưởng phải đi cùng cách làm, nhận định phải có dữ liệu, và lời giới thiệu tốt nhất là một sản phẩm chạy được. Chất công nghệ miền Nam: thẳng, nhanh, thực tế.

$ sata prove --with-demo

✓ Ý tưởng có bối cảnh thật

✓ Bài viết có lập luận & diagram

✓ Project có sản phẩm chạy được

→ nói ít hơn · cho xem nhiều hơn

▶ RUN
10.8231° N · 106.6297° E
NGHĨ CÓ CƠ SỞVấn đề thật, dữ liệu thật, góc nhìn rõ
LÀM CÓ DEMOBiến ý tưởng thành thứ chạm và thử được
NÓI CÓ BẰNG CHỨNGCode, diagram và sản phẩm thay cho khẩu hiệu
GÓP Ý THẲNGPhản hồi thật để cùng làm tốt hơn
Proof of work

Không chỉ kể. Cho cộng đồng xem thứ bạn làm.

SATA Demo Standard · v1.0

Đóng gói một lần.
Chạy được ở mọi nơi.

Live Demo là static website gắn với một Post. SATA kiểm tra ZIP, admin đọc mô tả và chạy thử staging trước khi public.

01BUILD

Xuất static site

Dùng npm run build hoặc công cụ tương đương. Demo phải chạy hoàn toàn phía trình duyệt.

02PACK

ZIP đúng thư mục

index.html phải nằm ngay ở gốc ZIP. Đóng các file bên trong dist/, không ZIP thư mục cha.

03SUBMIT

Gắn vào Post

Viết mô tả, hướng dẫn sử dụng và upload file .zip trong form Create Post.

04REVIEW

Admin chạy thử

Build mở trên preview origin riêng. Chỉ sau khi approve, demo mới xuất hiện trong Live Lab.

Cấu trúc ZIP chuẩn
your-demo.zip
├── index.html       ← bắt buộc
├── assets/
│   ├── app.js
│   └── app.css
├── images/
└── README.md        ← khuyến khích
Không nên: your-demo/dist/index.html
Checklist trước khi upload
  • Static onlyKhông cần Node.js, PHP hay server riêng.
  • Asset portableƯu tiên ./assets/...; không hard-code domain local.
  • Không có secretKhông đóng gói API key, token hoặc file .env.
  • Giới hạn 50 MBTối ưu hình, font và bundle trước khi ZIP.
  • Responsive & accessibleChạy trên mobile, có keyboard focus và đủ tương phản.
  • SPA compatibleRoute phụ nên fallback về index.html.
project

DocFlow Studio – Đọc Markdown, Mermaid và Graphviz ngay trên trình duyệt, không cần cài đặt

@badculi · 24/9/2026
documentationmarkdownmermaidgraphvizdiagramdeveloper-toolsvanilla-jsofflineopen-sourceside-project

📄 DocFlow Studio – Một file HTML cho cả workspace tài liệu kỹ thuật

Khi làm tài liệu kỹ thuật, mình thường có khá nhiều file Markdown đi kèm với Mermaid, sơ đồ kiến trúc, flow xử lý hoặc Graphviz DOT.

Vấn đề là đôi khi mình chỉ muốn:

Mở một folder tài liệu → chọn file → đọc Markdown và xem diagram ngay.

Nhưng nhiều công cụ documentation lại yêu cầu NodeJS, package manager, build project hoặc phải chạy thêm server.

Vì vậy mình làm DocFlow Studio theo hướng ngược lại:

Không backend. Không build. Không cài đặt. Chỉ cần một file HTML.

💡 Ý tưởng

DocFlow Studio là một documentation viewer/editor chạy hoàn toàn trên trình duyệt.

Chỉ cần mở:

docflow-studio.html

là có thể bắt đầu viết hoặc import tài liệu.

Mục tiêu của project là tạo một công cụ đủ nhẹ để có thể mang theo cùng source code, tài liệu hệ thống hoặc gửi cho người khác sử dụng ngay.

✍️ Markdown Editor

Có thể viết Markdown và xem kết quả render trực tiếp.

Hỗ trợ:

  • Live Markdown editing
  • Auto preview
  • Export Markdown
  • Export HTML
  • Export PDF thông qua trình duyệt

Không cần chạy Markdown server riêng.

📊 Mermaid Diagram

Các block Mermaid trong Markdown được tự động nhận diện và render.

Ví dụ:

flowchart LR

User --> Browser
Browser --> Markdown
Markdown --> Mermaid
Mermaid --> Viewer

Có thể sử dụng cho:

  • Flowchart
  • Sequence Diagram
  • State Diagram
  • Class Diagram
  • Entity Relationship Diagram

Khá tiện khi viết tài liệu kiến trúc hoặc mô tả luồng xử lý.

🔗 Graphviz DOT

Ngoài Mermaid, DocFlow Studio hỗ trợ luôn Graphviz DOT.

digraph G {
  rankdir=LR;

  users [label="Users / Admin"];
  web [label="Web Layer"];
  app [label="Application"];

  users -> web [label="HTTPS / UI"];
  web -> app [label="submit config"];
}

Các fenced block:

dot
graphviz
gv

đều có thể được nhận diện và render.

🔍 Diagram Viewer

Với những diagram lớn, xem trực tiếp bên trong document thường khá khó.

Vì vậy mình làm thêm một viewer riêng cho diagram với:

  • Zoom In / Zoom Out
  • Kéo để di chuyển diagram
  • Fit to screen
  • Xem source
  • Copy source
  • Export SVG
  • Export PNG

Có thể mở riêng từng Mermaid hoặc Graphviz diagram để kiểm tra.

📂 Import cả folder tài liệu

Đây là phần mình thấy hữu ích nhất khi dùng cho documentation thực tế.

Thay vì import từng file, có thể chọn luôn một folder chứa:

docs/
├── architecture.md
├── database.md
├── deployment.md
├── network.md
└── api.md

DocFlow Studio sẽ đọc các file:

.md
.markdown
.txt

Sau đó có thể tìm kiếm và chuyển qua lại giữa các file ngay trong workspace.

Nếu muốn đọc toàn bộ tài liệu liên tục, chỉ cần chọn:

Render All

Các file sẽ được ghép thành một document duy nhất.

💾 Workspace được lưu lại

Nội dung làm việc được lưu bằng Local Storage.

Khi đóng trình duyệt rồi mở lại, workspace trước đó có thể được khôi phục.

Folder đã import cũng được cache để hạn chế việc phải chọn lại sau mỗi lần refresh.

🧰 Technology Stack

Project cố tình giữ stack đơn giản:

  • HTML5
  • Vanilla JavaScript
  • Marked.js
  • Mermaid.js
  • Viz.js / Graphviz DOT

Không React.

Không NodeJS runtime.

Không database.

Không backend.

🎯 Tại sao mình làm project này?

Mình không muốn DocFlow Studio trở thành một documentation platform lớn.

Mục tiêu đơn giản hơn:

Có một file HTML mà mình có thể bỏ vào bất kỳ project nào để đọc nhanh toàn bộ tài liệu kỹ thuật của project đó.

Đặc biệt hữu ích với repository có nhiều Markdown và diagram nhưng không muốn dựng thêm Docsify, Docusaurus, MkDocs hay một hệ thống documentation riêng.

Tải file về, mở trình duyệt và sử dụng.

Đó cũng là lý do toàn bộ ứng dụng được thiết kế để có thể hoạt động chỉ với một file HTML.


Project hiện vẫn đang được mình tiếp tục hoàn thiện.

Mình rất muốn nhận thêm góp ý, đặc biệt từ những bạn thường xuyên phải viết architecture docs, deployment docs, database docs hoặc technical diagrams.

Nếu mọi người thấy còn tính năng nào mà một tool documentation dạng single-file + offline nên có, cứ góp ý để mình bổ sung. 🚀

Đang tải trang cá nhân...
Create Post

Tạo bài đăng

Đặt con trỏ trong nội dung rồi chọn Image để tải và chèn ảnh (tối đa 5 MB).

Ảnh giao diện, screenshot hoặc sơ đồ minh họa project. Mỗi ảnh tối đa 5 MB.

Live Demo (optional)

Bất kỳ Post Type nào cũng có thể kèm static demo.

SATA Administration

Admin

Quản trị SATA Tech Playground

Duyệt bài, quản lý tài khoản và review Live Demo trước khi public.

Secure access
Đang tải nội dung review...