Postgres

While NuxtHub provides an excellent developer experience, you can also use Postgres and AWS S3 with Supersaas. This guide will show you how to set it up.

Using Postgres

1. First, checkout the postgres branch of the repository:

git checkout postgres

2. Add your Postgres connection URL to your .env file:

POSTGRES_URL="postgresql://[email protected]:5432/your-database-name"

That's it! The schema, migrations, and database configuration are already set up for you in the postgres branch.

Postgres Configuration

You can either use Postgres directly or use hosted services like Neon and get the POSTGRES_URL from their dashboard.

Setting up S3 storage

Since we removed NuxtHub, we need to set up S3 storage manually and Supersaas uses Unjs Unstorage as a unified storage layer with the S3 driver for file operations.

The configuration is already handled for you once these environment variables are set.

S3_ACCESS_KEY_ID=XXXXXXXXX
S3_SECRET_ACCESS_KEY=XXXXXXXXXX
S3_BUCKET=your-bucket-name
S3_REGION=your-region
S3_ENDPOINT=your-endpoint
S3_PUBLIC_ENDPOINT=your-public-endpoint

This will work with any S3 compatible storage service.

• AWS S3
• Cloudflare R2
• Digital Ocean Spaces

Package.json Changes

When you switch to the postgres branch, the package.json is automatically updated to remove NuxtHub-related dependencies and include the necessary Postgres packages.

Next Steps

Once you've set up your database and storage:

1. Run your migrations - see migrations
2. Start your development server
3. Test file uploads to ensure S3 is configured correctly

You're now ready to use Supersaas with Postgres and AWS S3!