Configuración manual

La forma más rápida de crear un nuevo sitio Saasfly es utilizar create saasfly como se muestra en la guía de instalación.

Requisitos del sistema

Node.js - 18.17 o posterior.
Bun - 1.0 o posterior.
OS - Se admiten macOS, Windows (incluido WSL) y Linux.

Por cierto, recomendamos usar NVM (Node Version Manager) para ejecutar diferentes versiones de Node.js.

1. Instalación manual

Para crear manualmente una nueva aplicación Saasfly, sólo necesita unos pocos pasos:

Repositorio de bifurcación y clonación de GitHub

Abra https://github.com/saasfly/saasfly y bifurque este repositorio.

Una bifurcación es una copia de un repositorio. Bifurcar un repositorio le permite experimentar libremente con los cambios sin afectar el proyecto original.

Clone el repositorio bifurcado (reemplace <your_username> por el nombre de su cuenta de GitHub):

git clone https://github.com/<your_username>/saasfly.git

Verás el procedimiento de clonación:

remote: Enumerating objects: 402, done.
remote: Counting objects: 100% (402/402), done.
remote: Compressing objects: 100% (298/298), done.
remote: Total 402 (delta 77), reused 386 (delta 65), pack-reused 0
Receiving objects: 100% (402/402), 963.18 KiB | 130.00 KiB/s, done.
Resolving deltas: 100% (77/77), done.

Instalar las dependencias

Para una mejor experiencia, utilice Bun (Cómo instalar Bun), en lugar de npm o yarn.

Usando bun para instalar las dependencias:

bun i

Puede que le cueste varios minutos y luego verá:

+ @saasfly/api@workspace:packages/api
+ @saasfly/auth@workspace:packages/auth
+ @saasfly/common@workspace:packages/common
+ @saasfly/db@workspace:packages/db
+ @saasfly/eslint-config@workspace:tooling/eslint-config
+ @saasfly/nextjs@workspace:apps/nextjs
+ @saasfly/prettier-config@workspace:tooling/prettier-config
+ @saasfly/stripe@workspace:packages/stripe
+ @saasfly/tailwind-config@workspace:tooling/tailwind-config
+ @saasfly/typescript-config@workspace:tooling/typescript-config
+ @saasfly/ui@workspace:packages/ui
+ @turbo/[email protected] (v1.12.4 available)
+ [email protected]
+ [email protected]
+ [email protected] (v1.12.4 available)
+ [email protected]

1296 packages installed [1133.89s]

Generar tipos de prisma

Asegúrese de estar en la carpeta saasfly y luego use bun para generar tipos de Prisma:

cd packages/db/
bun db:generate

Producción:

✔ Generated Kysely types(1.7.1) to./ prisma in 1.32s

2. Iniciar Saasfly

Debe hacer las siguientes listas para ejecutar el servidor.

Configurar las variables de entorno

Ingrese a la carpeta saasfly, duplique el archivo .env.example , cámbiele el nombre a .env.local e ingrese sus variables.

cd saasfly
cp .env.example .env.local

Asegúrese de tener una base de datos Postgres (Si no tienes un Postgres, haz clic aquí) y haber creado una nueva base de datos.

POSTGRES_URL debe estar en su archivo .env.local:

# Ejemplo de formato
# POSTGRES_URL="postgres://{USER}:{PASSWORD}@{DB_HOST}:{DB_PORT}/{DATABASE}"

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

Luego, use bun para crear tablas de base de datos:

bun db:push

Producción:

🚀  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                          │
└─────────────────────────────────────────────────────────┘

Si algo salió mal, puedes hablar con nosotros en Discord, estaremos encantados de responder cualquier cosa sobre Saasfly.

Ejecute la compilación primero

Debido a que algunos componentes básicos son necesarios en tiempo de compilación, primero debe run build .

bun run build

Ejecute el servidor de desarrollo

Utilice bun run para iniciar su servidor web:

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

Si todo va bien, Saasfly ahora debería estar sirviendo su proyecto en http://localhost:3000 y podrá ver el resultado:

¡Felicidades! Ahora puedes empezar a codificar para construir tu SaaS.

Si es nuevo en Saasfly, consulte los documentos estructura del proyecto para obtener una descripción general de todos los archivos y carpetas posibles en su aplicación.

Corre con Stripe

Lea el artículo Stripe. Y luego usa bun dev para ejecutar con Stripe:

bun dev