Rust Axum Saas Template

Minimum Required Rust Version: 1.75.0

async trait

This repository contains a Rust Axum-based web application with SQLx, PostgreSQL database, and authentication features for a SaaS template. Follow the steps below to set up and run the project.

Development Setup

Install sqlx-cli:
```
cargo install sqlx-cli
```
Run the Database Setup Script: Execute the following commands in your terminal:
```
./db.sh
sqlx-cli db setup
```
Run the Application:
```
cargo run
```

Building for Production

Ensure that you can successfully run the application in development mode before proceeding.

Run the Build Script:
```
./build.sh
```
Run Docker Compose:
```
docker-compose up
```

Available Routes

Home:
- Method: GET
- URL: {{base_url}}/
Login Form:
- Method: GET
- URL: {{base_url}}/login

Login:

Method: POST
URL: {{base_url}}/api/auth/login

Body:

{
  "email": "{{email}}",
  "password": "{{password}}"
}

Protected Resource:
- Method: GET
- URL: {{base_url}}/api/protected

Register:

Method: POST
URL: {{base_url}}/api/auth/register

Body:

{
  "username": "haheho",
  "email": "senpai@mail.com",
  "password": "Doplhin123!"
}

User email verification:
- Method: POST
- URL: {{base_url}}/api/auth/verify-email/:token
Send Reset Password:
- Method: POST
- URL: {{base_url}}/api/auth/reset-password
- Body:
```
{
  "email": "senpai@mail.com"
}
```
Verify Reset Password:
- Method: POST
- URL: {{base_url}}/api/auth/reset-password/:token
- Body:
```
{
  "password": "Dolphin123!"
}
```

Variables

base_url: Set your base URL.
email: Set the email for testing.
password: Set the password for testing.

Credits

This project is inspired by and incorporates elements from the following repositories:

Realworld Axum SQLx by David Pedersen
Rust Axum Course by Jeremy Chone
Cargo Chef by Luke Math Walker
Lucia Auth by pilcrow