Skip to main content
ProStack uses PostgreSQL as its database and Prisma as the ORM (Object-Relational Mapping) tool for database operations.

​
Database Setup

Before you can use the database, make sure you have:
  1. Installed PostgreSQL on your system
  2. Created a database for your application
  3. Updated the DATABASE_URL in your .env file
DATABASE_URL="postgresql://<username>:<password>@localhost:5432/<mydb>"

​
Prisma Schema

The Prisma schema defines your database models and relationships. In ProStack, the schema is located in prisma/schema.prisma.
When you modify the schema, you need to synchronize these changes with your database.

​
Database Commands

ProStack includes several commands to manage your database: 
# Apply schema changes without migrations
bun run db:push

​
Working with Prisma Client

ProStack provides a configured Prisma client in lib/db.ts that you can import and use in your application: 
import { db } from "@/lib/db";

// Example: Fetch all users
async function getAllUsers() {
  return await db.user.findMany();
}

// Example: Create a new post
async function createPost(userId: string, title: string, content: string) {
  return await db.post.create({
    data: {
      title,
      content,
      userId
    }
  });
}

​
Database Relationships

Prisma makes it easy to work with relationships between tables. For example, to fetch a user with their posts: 
async function getUserWithPosts(userId: string) {
  return await db.user.findUnique({
    where: { id: userId },
    include: { posts: true }
  });
}

​
Using Transactions

For operations that require multiple database changes, use transactions to ensure data consistency: 
async function transferPoints(fromUserId: string, toUserId: string, amount: number) {
  return await db.$transaction(async (tx) => {
    // Deduct points from sender
    await tx.user.update({
      where: { id: fromUserId },
      data: { points: { decrement: amount } }
    });
    
    // Add points to receiver
    await tx.user.update({
      where: { id: toUserId },
      data: { points: { increment: amount } }
    });
    
    // Create transaction record
    await tx.pointTransaction.create({
      data: {
        amount,
        fromUserId,
        toUserId
      }
    });
  });
}

​
Database Migrations

In production environments, it’s recommended to use migrations instead of db push:
  1. Create a migration:
bun run db:migrate:dev --name add_user_profile
  1. Apply migrations in production:
bun run db:migrate:deploy

​
Docker Database Setup

If you’re using Docker for development, update your DATABASE_URL in the .env.docker file: 
DB_USER=<username>
DB_PASSWORD=<password>
DB_HOST=pghost    # Use 'pghost' instead of 'localhost' for Docker
DB_PORT=5432
DB_NAME=<mydb>

DATABASE_URL=postgresql://${DB_USER}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_NAME}

​
Next Steps

Docker Deployment

Deploy your application using Docker

Authentication

Learn about the authentication system
⌘I