🧰 Workspace Kit - Production-Ready Backend in Rust (Ignitia Framework)

• ✅ Complete Authentication & Authorization System
• ✅ Modular Architecture for Workspaces, Roles, Permissions
• ✅ Built with Rust & Ignitia — Secure, Performant, Scalable

Welcome to the Workspace Kit, a commercial-ready backend API template designed for building SaaS platforms, collaboration tools, and role-based management systems. This project is crafted with best practices in Rust and uses the Ignitia web framework, making it highly reliable, secure, and easy to maintain.

💡 What You Get

• ✅ Fully working backend API
• ✅ Clean, production-grade codebase in Rust
• ✅ JWT-based authentication system
• ✅ Role-based access control (RBAC)
• ✅ Workspace creation & user invitation logic
• ✅ Password reset, email change & verification
• ✅ Full Postman collection for API testing
• ✅ .env setup & project ready to run locally
• ✅ Built on Ignitia - High-performance web framework

📦 Folder Structure

workspace-kit/
│
├── src/
│   ├── config/              # App & environment configuration
│   ├── database/            # Database operations & connection pool
│   ├── dtos/                # Data Transfer Objects for API responses
│   ├── handlers/            # Auth, User & Workspace API Handlers
│   ├── mail/                # Email sending & verification
│   ├── middleware/          # Authentication Middleware with User role & Permission
│   ├── utils/               # Token handling, password hashing, etc.
│   ├── constants.rs         # All Permission constants
│   ├── routes.rs            # All API routes
│   ├── error.rs             # Error handling
│   ├── models.rs            # Database models
│   └── main.rs              # App entrypoint
├── migrations/              # SQL migration files
├── .env                     # Environment variables
├── .env.example             # Example environment configuration
├── .gitignore               # Git ignore file
├── Cargo.toml               # Rust project manifest
├── LICENSE                  # License file
└── README.md                # Project documentation

🚀 How to Run the Project

1. Clone or Unzip the Project

git clone https://github.com/AarambhDevHub/workspace-kit-ignitia.git
cd workspace-kit-ignitia

Or extract the workspace-kit-ignitia.zip file you received after purchase.

2. Setup Your Environment

The project includes a pre-filled .env.example file.

Steps:

1. Duplicate .env.example and rename it to .env:

   cp .env.example .env
   

2. Update the following fields in .env:

   Key	Description
   DATABASE_URL	Your PostgreSQL connection string (e.g. postgres://user:password@localhost/workspace_db)
   SMTP_SERVER	Your SMTP server (e.g. smtp.gmail.com)
   SMTP_PORT	SMTP port (e.g. 587)
   SMTP_USERNAME	Your email address or SMTP username
   SMTP_PASSWORD	Your email app password or SMTP password
   SMTP_FROM_ADDRESS	The name or address the emails will come from
   JWT_SECRET_KEY	A secure random string used to sign tokens
   SERVER_HOST	Server host (default: 127.0.0.1)
   SERVER_PORT	Server port (default: 8080)

3. Install Dependencies

Ensure Rust is installed (1.70 or higher). Then:

cargo build

4. Setup PostgreSQL Database

# Create database
createdb workspace_db

# Or using psql
psql -U postgres
CREATE DATABASE workspace_db;
\q

5. Run Migrations

If you're using SQLx, install the CLI:

cargo install sqlx-cli --no-default-features --features postgres
sqlx database create
sqlx migrate run

6. Start the Server

cargo run --release

The server will start at http://127.0.0.1:8080

📬 Postman API Collection

A ready-to-import Postman collection is included: 📁 Workspace-kit.postman_collection.json

Import it into Postman and start testing endpoints like:

• POST /api/auth/register
• POST /api/auth/login
• GET /api/user/me
• POST /api/workspace/create
• GET /api/workspace/list
• POST /api/role/create
• POST /api/permission/assign
• and more...

🛡️ Tech Stack

• Framework: Ignitia - High-performance Rust web framework
• Database: PostgreSQL with SQLx
• Authentication: JWT (JSON Web Tokens)
• Password Hashing: Argon2
• Email: SMTP integration
• Architecture: Layered (handlers, services, middleware, models)
• Async Runtime: Tokio

🏗️ Architecture

Layered Architecture

Request → Middleware (JWT Auth) → Handler → Service Layer → Database → Response

Key Components

1. Handlers: Process HTTP requests and responses
2. Middleware: JWT authentication and permission checking
3. Services: Business logic layer
4. Database: Data persistence with SQLx
5. Utils: Helper functions (hashing, tokens, validation)
6. DTOs: Data Transfer Objects for API contracts

Permission System

// Example permission constants
pub const WORKSPACE_CREATE: &str = "workspace:create";
pub const WORKSPACE_UPDATE: &str = "workspace:update";
pub const WORKSPACE_DELETE: &str = "workspace:delete";
pub const USER_INVITE: &str = "user:invite";
pub const ROLE_MANAGE: &str = "role:manage";

🔒 Security Features

• ✅ Argon2 Password Hashing - Industry-standard password security
• ✅ JWT Authentication - Stateless authentication with access/refresh tokens
• ✅ Role-Based Access Control (RBAC) - Granular permission system
• ✅ Email Verification - Secure account activation
• ✅ Password Reset - Secure password recovery
• ✅ SQL Injection Prevention - Parameterized queries with SQLx
• ✅ CORS Configuration - Cross-origin request handling
• ✅ Rate Limiting Ready - Easy to integrate with Ignitia middleware

📈 Use Case Ideas

• 🚀 Team Collaboration Platform - Slack/Discord alternative
• 📋 Project Management Tool - Trello/Asana clone
• 🏢 Multi-Tenant SaaS Product - Customer management platform
• 🔐 Internal Company Dashboard - Employee portal with RBAC
• 💼 Client Management System - Agency workspace management
• 🎓 Learning Management System - Course and student management
• 🏥 Healthcare Portal - Patient and provider management

🐛 Troubleshooting

Database Connection Issues

# Check PostgreSQL is running
pg_isready

# Test connection
psql -U postgres -d workspace_db

JWT Token Issues

• Ensure JWT_SECRET_KEY is set in .env
• Check token expiration settings
• Verify Authorization header format: Bearer <token>

Email Not Sending

• Verify SMTP credentials in .env
• Check firewall/port settings
• Enable "Less secure app access" for Gmail (or use App Passwords)

Port Already in Use

# Change SERVER_PORT in .env file
SERVER_PORT=8081

📦 Dependencies

[dependencies]
ignitia = "0.2.4"
tokio = { version = "1", features = ["full"] }
serde = { version = "1.0", features = ["derive"] }
serde_json = "1.0"
sqlx = { version = "0.7", features = ["runtime-tokio-rustls", "postgres", "uuid", "chrono"] }
argon2 = "0.5"
jsonwebtoken = "9.0"
uuid = { version = "1.0", features = ["v4", "serde"] }
chrono = { version = "0.4", features = ["serde"] }
dotenvy = "0.15"
tracing = "0.1"
tracing-subscriber = { version = "0.3", features = ["env-filter"] }
lettre = "0.11"
thiserror = "1.0"
validator = { version = "0.18", features = ["derive"] }

🚀 Deployment

Docker Deployment

FROM rust:1.75 as builder
WORKDIR /app
COPY . .
RUN cargo build --release

FROM debian:bookworm-slim
RUN apt-get update && apt-get install -y libssl-dev ca-certificates
COPY --from=builder /app/target/release/workspace-kit /usr/local/bin/
CMD ["workspace-kit"]

Environment Variables for Production

DATABASE_URL=postgres://user:password@db:5432/workspace_db
JWT_SECRET_KEY=<strong-random-string>
SERVER_HOST=0.0.0.0
SERVER_PORT=8080
RUST_LOG=info

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📞 Support

If you need installation help, feature customization, or integration services, join our official Discord community: 👉 https://discord.gg/HDth6PfCnp

We're here to help you get started and answer your questions!

📜 License

MIT License - See LICENSE for details.

🙏 Thank You

Thanks for choosing the Workspace Kit! We hope this saves you weeks of backend development time.

Built with ❤️ using Ignitia - A blazing fast Rust web framework

Happy coding! 🚀

📚 Related Projects

• Ignitia Framework - The underlying web framework
• Ignitia Chat App - Real-time chat with WebSocket support

---

Note: This is a production-ready template. Customize it according to your specific business needs. For enterprise support and custom development, contact us through Discord.