Workspace Organization

​

Organization Strategies

​

By Project

~/Auk/
├── project-alpha/
│   ├── collections/
│   │   ├── backend-api.json
│   │   └── frontend-api.json
│   └── environments/
│       ├── dev.json
│       └── prod.json
├── project-beta/
└── project-gamma/

• Multiple independent projects
• Different tech stacks
• Separate teams per project

​

By Client

~/Auk/
├── client-acme/
├── client-globex/
├── client-initech/
└── internal/

• Consulting/agency work
• Multiple clients
• Client-specific configurations

​

By Environment

~/Auk/
├── development/
├── staging/
└── production/

• Testing environment-specific configurations
• Preventing accidental production changes
• Clear environment separation

​

Collection Organization

​

Folder Structure

User Management API
├── Authentication
│   ├── Login
│   ├── Logout
│   └── Refresh Token
├── Users
│   ├── List Users
│   ├── Create User
│   ├── Get User
│   ├── Update User
│   └── Delete User
└── Roles
    ├── List Roles
    └── Assign Role

​

Naming Conventions

• User Management API
• Payment Processing API
• Notification Service API

• GET /users - List Users
• POST /users - Create User
• PUT /users/:id - Update User

​

Environment Management

​

Environment Strategy

environments/
├── development.json
├── staging.json
└── production.json

environments/
├── base.json
├── dev-override.json
└── prod-override.json

​

Best Practices

# Team API Collections

## Structure
- `auth/` - Authentication endpoints
- `users/` - User management
- `payments/` - Payment processing

## Environments
- `dev` - Local development
- `staging` - Staging server
- `prod` - Production (use carefully!)

​

Next Steps