Pular para o conteúdo
Saasfly Docs

Configuração manual

A maneira mais rápida de criar um novo site Saasfly é usando create saasfly conforme mostrado no guia de instalação.

Requisitos de sistema

  • Node.js - 18.17 ou posterior.
  • Bun - 1.0 ou posterior.
  • OS - macOS, Windows (incluindo WSL) e Linux são suportados.

A propósito, recomendamos o uso de NVM (Node Version Manager) para executar diferentes versões do Node.js.

1. Instalação manual

Para criar manualmente um novo aplicativo Saasfly, bastam alguns passos:

Repositório Fork e Clone do GitHub

Abra https://github.com/saasfly/saasfly e bifurque este repositório.

Um fork é uma cópia de um repositório. A bifurcação de um repositório permite que você experimente alterações livremente sem afetar o projeto original.

Clone o repositório bifurcado (substitua <your_username> pelo nome da sua conta do GitHub):

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

Você verá o procedimento de clonagem:

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.

Instale as dependências

Para uma melhor experiência, use Bun (Como instalar o Bun), em vez de npm ou yarn.

Usando bun para instalar as dependências:

Terminal window
bun i

Pode custar vários minutos e então você 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]

Gerar tipos Prisma

Por favor, certifique-se de estar na pasta saasfly e, em seguida, use bun para gerar os tipos Prisma:

Terminal window
cd packages/db/
bun db:generate

Saída:

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

2. Inicie o Saasfly

Você deve seguir as listas abaixo para executar o servidor.

Configure as variáveis ​​de ambiente

Entre na pasta saasfly, duplique o arquivo .env.example, renomeie-o para .env.local e insira suas variáveis.

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

Certifique-se de ter um banco de dados Postgres (Se você não possui Postgres, clique aqui) e de ter criado um novo banco de dados.

POSTGRES_URL deve estar em seu arquivo .env.local:

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


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

Então, use bun para criar tabelas de banco de dados:

Terminal window
bun db:push

Saída:

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

Se algo deu errado, você pode falar conosco no Discord , teremos prazer em responder qualquer coisa sobre o Saasfly.

Execute a compilação primeiro

Como alguns componentes básicos são necessários em tempo de compilação, você deve run build primeiro.

Terminal window
bun run build

Execute o servidor de desenvolvimento

Use bun run para iniciar seu servidor web:

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

Se tudo correr bem, o Saasfly deverá agora servir seu projeto em http://localhost:3000, e você poderá ver o resultado:

Configuração manual

Parabéns! Agora você pode começar a codificar para construir seu SaaS.

Se você é novo no Saasfly, consulte a documentação da estrutura do projeto para obter uma visão geral de todos os arquivos e pastas possíveis em seu aplicativo.

Corra com Stripe

Por favor, leia o artigo Stripe. E então use bun dev para rodar com Stripe:

Terminal window
bun dev