SaaS Template Documentation

This guide explains how to install, customize, and deploy a BloomTPL SaaS template built with Next.js 15, Tailwind CSS, shadcn/ui, Prisma, NextAuth, and Stripe.

1. Installation

Download the template: After purchase, download the ZIP file and extract it to your workspace.
Install dependencies:
```
npm install
```
Set up environment variables: Copy .env.example to .env and fill in your database, authentication, and Stripe keys.
```
cp .env.example .env
```
- DATABASE_URL – Your PostgreSQL or MySQL connection string
- NEXTAUTH_SECRET – A random string for NextAuth
- STRIPE_SECRET_KEY – Your Stripe secret key
- STRIPE_PUBLIC_KEY – Your Stripe public key
Set up the database: Run Prisma migrations to create the database tables.
```
npx prisma migrate dev
```
Start the development server:
```
npm run dev
```
Your app will be running at http://localhost:3000.

2. Customization

Edit content: Modify pages in the /app directory and components in /components to update text, images, and layout.
Change styles: Update Tailwind CSS classes directly in your JSX. You can also edit tailwind.config.js to customize your color palette, fonts, and breakpoints.
Use shadcn/ui components: All UI elements use shadcn/ui. You can add new components by running:
```
npx shadcn-ui@latest add [component]
```
Replace [component] with the desired UI element (e.g., button, card).
Update authentication: Configure NextAuth providers in /app/api/auth/[...nextauth]/route.ts and update the sign-in page as needed.
Update Stripe integration: Edit Stripe keys in .env and customize payment logic in /app/api/ and related components.
Update metadata: Edit app/layout.tsx and page-level metadata for SEO and social sharing.

3. Deployment

Build your app:
```
npm run build
```
Deploy to your preferred platform: You can deploy to platforms like Netlify, AWS Amplify, Render, or your own server. Make sure to set NODE_ENV=production and run npm run build before serving.
Set environment variables: Ensure your production environment has all required variables from .env.
Run database migrations: On your server, run:
```
npx prisma migrate deploy
```

Troubleshooting & Tips

If you see build errors, check your Node.js version (Next.js 15 requires Node 18+).
For Prisma issues, see the Prisma docs.
For NextAuth configuration, see the NextAuth docs.
For Stripe integration, see the Stripe docs.
For shadcn/ui issues, refer to the official documentation.
For Tailwind CSS customization, see the Tailwind docs.

Need Help?

If you have any questions or run into issues, contact our support team at bloomtpl@gmail.com.