Gia Phả OS (Gia Phả Open Source)

 Nguồn: https://github.com/homielab/giapha-os?tab=readme-ov-file

Cài đặt và Chạy dự án

Chỉ cần khoảng 10 -> 15 phút là bạn có thể tự dựng hệ thống gia phả cho gia đình mình.

---

1. Tạo Database (Miễn phí với Supabase)

1. Tạo tài khoản miễn phí tại https://github.com nếu chưa có.
2. Tạo tài khoản miễn phí tại https://supabase.com nếu chưa có (khuyên dùng đăng ký bằng tài khoản GitHub cho nhanh).
3. Tạo New Project. Đợi khoảng 1 -> 2 phút để hệ thống khởi tạo xong.
4. Vào Project Settings → API, giữ lại 2 giá trị này để dùng ở bước tiếp theo:
   • Project URL
   • Project API Keys

---

Cách 1: Deploy nhanh lên Vercel

1. Tạo tài khoản miễn phí tại https://vercel.com nếu chưa có (khuyên dùng đăng ký bằng tài khoản GitHub cho nhanh).
2. Điền các biến môi trường đã lưu ở bước 1:
   • NEXT_PUBLIC_SUPABASE_URL = Project URL
   • NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY = Project API Keys
3. Nhấn Deploy và chờ 2 -> 3 phút.

Bạn sẽ có một đường link website  vd https://donghonguyenkhacos.vercel.app/để sử dụng ngay.

---

Cách 2: Chạy trên máy cá nhân

Yêu cầu: máy đã cài Node.js và Bun

1. Clone hoặc tải project về máy.
2. Đổi tên file .env.example thành .env.local.
3. Mở file .env.local và điền các giá trị đã lưu ở bước 1.

NEXT_PUBLIC_SUPABASE_URL="https://your-project.supabase.co"
NEXT_PUBLIC_SUPABASE_PUBLISHABLE_DEFAULT_KEY="your-anon-key"

4. Cài thư viện

bun install

5. Chạy dự án

bun run dev

Mở trình duyệt và truy cập: http://localhost:3000

---

Tài khoản đầu tiên

• Đăng ký tài khoản mới khi vào web lần đầu.
• Người đăng ký đầu tiên sẽ tự động có quyền admin.
• Các tài khoản đăng ký sau sẽ mặc định là member.

Read more »

Posted in: gia phả