Bỏ qua nội dung
Saasfly Docs

Cài đặt

Sẵn sàng cài đặt Saasfly? Hãy làm theo hướng dẫn này để sử dụng CLI create saasfly để bắt đầu.

yêu cầu hệ thống

  • Node.js - 18.17 trở lên..
  • Bun - 1.0 trở lên.
  • OS - macOS, Windows (bao gồm WSL) và Linux đều được hỗ trợ.

Nhân tiện, chúng tôi khuyên bạn nên sử dụng NVM (Node Version Manager) để chạy các phiên bản khác nhau của Node.js.

1. Chạy Trình hướng dẫn thiết lập

Chạy lệnh sau trong terminal của bạn để bắt đầu trình hướng dẫn cài đặt tiện dụng của chúng tôi:

Terminal window
bun create saasfly

Khi cài đặt, bạn sẽ thấy những lời nhắc sau:

  1. Sao chép kho lưu trữ saasfly vào thư mục đã chỉ định.
  2. Xóa lịch sử git
  3. Cài đặt các phụ thuộc
  4. Tạo loại Prisma

Sau khi nhắc, create saasfly sẽ tạo một thư mục có tên dự án của bạn và cài đặt các phụ thuộc cần thiết.

2. Bắt đầu Saasfly

Bạn nên thực hiện các bước dưới đây để chạy máy chủ.

Thiết lập các biến môi trường

Vào thư mục saasfly, sao chép tệp .env.example, đổi tên thành .env.local và nhập các biến của bạn.

Terminal window
cd saasfly
cp .env.example .env.local

Đảm bảo bạn có Postgres DB (Nếu bạn không có Postgres, hãy nhấp vào đây) và đã tạo cơ sở dữ liệu mới.

POSTGRES_URL phải có trong tệp .env.local của bạn:

# Ví dụ định dạng
# POSTGRES_URL="postgres://{USER}:{PASSWORD}@{DB_HOST}:{DB_PORT}/{DATABASE}"


POSTGRES_URL="postgres://postgres:[email protected]:5432/saasfly"

Sau đó, sử dụng bun để tạo bảng cơ sở dữ liệu:

Terminal window
bun db:push

Đầu ra:

🚀  Your database is now in sync with your Prisma schema. Done in 151ms


┌─────────────────────────────────────────────────────────┐
│  Update available 5.9.1 -> 5.10.2                       │
│  Run the following to update                            │
│    npm i --save-dev prisma@latest                       │
│    npm i @prisma/client@latest                          │
└─────────────────────────────────────────────────────────┘

Nếu có gì không ổn, bạn có thể trao đổi với chúng tôi trên Discord, chúng tôi rất vui lòng giải đáp mọi thắc mắc về Saasfly.

Chạy bản dựng đầu tiên

Vì một số thành phần cơ bản cần phải biên dịch ngay nên trước tiên bạn phải run build .

Terminal window
bun run build

Chạy máy chủ phát triển

Sử dụng bun run để khởi động máy chủ web của bạn:

Terminal window
bun run dev:web
@saasfly/nextjs:dev: cache bypass, force executing ad8bea47f156e113
@saasfly/nextjs:dev: $ bun with-env next dev
@saasfly/nextjs:dev: $ dotenv -e ../../.env.local -- next dev
@saasfly/nextjs:dev:    ▲ Next.js 14.1.0
@saasfly/nextjs:dev:    - Local:        http://localhost:3000
@saasfly/nextjs:dev:
@saasfly/nextjs:dev:    automatically enabled Fast Refresh for 1 custom loader
@saasfly/nextjs:dev:  ✓ Ready in 12.1s

Nếu mọi việc diễn ra tốt đẹp, Saasfly sẽ chạy dự án của bạn trên http://localhost:3000 và bạn có thể thấy kết quả:

Installation

Xin chúc mừng! Bây giờ bạn có thể bắt đầu viết mã để xây dựng SaaS của mình.

Nếu bạn mới sử dụng Saasfly, hãy xem tài liệu cấu trúc dự án để biết tổng quan về tất cả các tệp và thư mục có thể có trong ứng dụng của bạn.

Chạy với Stripe

Vui lòng đọc bài viết Stripe. Sau đó sử dụng bun dev để chạy với Stripe:

Terminal window
bun dev