Appearance

Create DAM Instance ​

File Information ​

  • Path: pages/create-dam-instance.vue
  • Route: /create-dam-instance
  • Purpose: Create new DAM instance with full configuration

Overview ​

The Create DAM Instance page provides a comprehensive interface for creating a new DAM instance with full configuration options, including branding, settings, and initial setup.

Key Features ​

  1. Instance Creation

    • Instance name and description
    • Workspace selection
    • Initial configuration
    • Branding setup

  2. Configuration Options

    • Storage settings
    • Access control settings
    • Feature flags
    • Integration settings

  3. Branding Setup

    • Logo upload
    • Color customization
    • Initial branding configuration

  4. Validation

    • Form validation
    • Settings validation
    • Error handling

Components Used ​

  • Instance form components
  • Configuration components
  • Branding components
  • Validation components

Data Properties ​

javascript
{
  form: {
    name: '',
    description: '',
    workspace_id: null,
    branding: {
      logo: null,
      primary_color: ''
    },
    settings: {}
  },
  creating: false,    // Creation state
  errors: {},        // Form errors
  workspaces: []    // Available workspaces
}

Computed Properties ​

isFormValid ​

Validates form data

availableWorkspaces ​

Returns workspaces user can create instances in

Methods ​

loadWorkspaces() ​

Loads available workspaces:

  • Fetches user workspaces
  • Filters by permissions
  • Updates workspace list

createInstance() ​

Creates DAM instance:

  • Validates form
  • Uploads branding assets
  • Creates instance via API
  • Configures settings
  • Redirects to instance
  • Handles errors

uploadBranding(file) ​

Uploads branding assets:

  • Uploads logo
  • Updates branding URL
  • Handles upload errors

API Endpoints ​

Get Workspaces ​

  • Endpoint: GET /user/workspaces
  • Response: Array of workspace objects

Create DAM Instance ​

  • Endpoint: POST /dam/instance/create
  • Request Body: Instance creation data with branding
  • Response: Created instance object

Upload Branding ​

  • Endpoint: POST /dam/instance/upload-branding
  • Request: FormData with branding file
  • Response: Branding URL

User Flow ​

  1. User navigates to create DAM instance page
  2. User selects workspace
  3. User enters instance details
  4. User configures settings
  5. User uploads branding (optional)
  6. User submits form
  7. Instance is created
  8. User is redirected to instance
  9. Success message displayed

Notes for Development ​

  • Page requires appropriate permissions
  • Workspace selection required
  • Branding upload optional
  • Full configuration available
  • Redirects to instance after creation