Hoppa till innehåll

Manuell inställning

Det snabbaste sättet att skapa en ny Saasfly-webbplats är att använda create saasfly som visas i installationsguiden.

Systemkrav

  • Node.js - 18.17 eller senare.
  • Bun - 1.0 eller senare.
  • OS - macOS, Windows (inklusive WSL) och Linux stöds.

Förresten rekommenderar vi att du använder NVM (Node Version Manager) för att köra olika versioner av Node.js.

1. Manuell installation

För att manuellt skapa en ny Saasfly-app behöver du bara några steg:

Fork and Clone Repository från GitHub

Vänligen öppna https://github.com/saasfly/saasfly och dela detta förråd.

En gaffel är en kopia av ett förråd. Forking av ett arkiv låter dig experimentera fritt med ändringar utan att påverka det ursprungliga projektet.

Klona det delade förvaret (vänligen ersätt <your_username> till ditt kontonamn för GitHub):

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

Du kommer att se proceduren för kloning:

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.

Installera beroenden

För bättre upplevelse, använd Bun (How ​to install Bun) istället för npm eller yarn.

Använder bun för att installera beroenden:

Terminal window
bun i

Det kan kosta flera minuter och sedan ser du:

+ @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] (v1.12.4 available)
1296 packages installed [1133.89s]

Generera Prismatyper

Se till att du är i saasfly-mappen och använd sedan bun för att generera Prisma-typer:

Terminal window
cd packages/db/
bun db:generate

Produktion:

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

2. Starta Saasfly

Du bör göra nedanstående listor för att köra servern.

Ställ in miljövariabler

Gå in i saasfly-mappen, duplicera filen .env.example, byt namn på den till .env.local och ange dina variabler.

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

Se till att du har en Postgres DB (Om du inte har en Postgres, klicka här ) och har skapat en ny databas.

POSTGRES_URL måste i filen .env.local :

# Formatexempel
# POSTGRES_URL="postgres://{USER}:{PASSWORD}@{DB_HOST}:{DB_PORT}/{DATABASE}"
POSTGRES_URL="postgres://postgres:[email protected]:5432/saasfly"

Använd sedan bun för att skapa databastabeller:

Terminal window
bun db:push

Produktion:

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

Om något gick fel kan du prata med oss ​​på Discord , vi svarar gärna på allt om Saasfly.

Kör bygg först

Eftersom vissa grundläggande komponenter behövs för kompilering, bör du run build först.

Terminal window
bun run build

Kör utvecklingsservern

Använd bun run för att starta din webbserver:

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

Om allt går bra bör Saasfly nu betjäna ditt projekt på http://localhost:3000, och du kan se resultatet:

Installation

Grattis! Nu kan du börja koda för att bygga ditt SaaS.

Om du är ny på Saasfly, se projektstruktur dokumentationen för en översikt över alla möjliga filer och mappar i din applikation.

Spring Med Stripe

Läs artikeln Stripe. Och använd sedan bun dev för att köra med Stripe:

Terminal window
bun dev