Appearance
Core Features ​
Overview ​
This section documents the core features and systems that power the Admin Frontend application. Each feature is documented in depth with architecture, implementation details, code examples, and workflows.
Features ​
Management Modules ​
Comprehensive framework for organizing and managing different functional areas within the application. Includes module registration, navigation, and access control.
Tags & Custom Fields ​
Flexible metadata management system for digital assets. Supports tags, custom field definitions, validation, and search integration.
Tag Management ​
Comprehensive tags system for asset categorization and organization. Includes tag creation, management, bulk operations, search filtering, and asset integration.
Custom Fields ​
Comprehensive custom fields system for workspace-specific metadata management. Includes field definition management, asset integration, search filtering, and bulk operations.
Search & Discovery ​
Comprehensive search system with Typesense integration. Includes multi-collection search (assets, folders, collages), advanced filtering (tags, custom fields, file types, dates, users), search tabs, bulk actions, and real-time search suggestions.
Global Search ​
Unified search interface across assets, folders, and collages within a workspace. Details the search bar integration, result rendering, tab switching, and URL-driven search state.
Advanced Search Filters ​
Deep-dive into the filter panel: file-type chips, tag filters, custom-field filters, date pickers, user filters, and filter preset management. Covers Typesense facet queries and filter serialization.
Folder Listing & Detail ​
Folder list page and folder detail page implementation. Covers folder tree rendering, breadcrumb navigation, paginated asset listing within folders, and folder metadata display.
Folder Operations ​
Comprehensive folder management system through reusable dialog components. Includes folder creation, editing, moving, copying, deletion, and permission management. Supports multiple dialog types for various folder operations and integrates with pages and components across the DAM module.
Upload Flow ​
Admin upload system for authenticated users with direct uploads, chunked/multipart uploads, queue management, progress tracking, and error handling. External upload integration for guest users with OTP authentication.
Typesense Search ​
Complete Typesense setup, configuration, indexing strategy, and API integration for high-performance full-text search.
AWS S3 Storage ​
Secure, scalable cloud storage integration with support for direct uploads, multipart uploads, presigned URLs, and automatic thumbnail generation.
Sharing & Permissions ​
Secure sharing of digital assets, folders, and collages with fine-grained access control, password protection, expiration dates, and embed codes.
Role-Based Access ​
Fine-grained permission management system with roles, permissions, and access rules for different modules and resources.
Notifications ​
Comprehensive notification system with system notifications, announcements, email notifications, user and organization-level settings, and real-time badge counts.
Announcements ​
Workspace-level announcement management system for administrators. Includes announcement creation, editing, targeting, read/unread tracking, and display in notification bell.
Multi-Workspace ​
Comprehensive multi-workspace system enabling users to work across multiple workspaces. Includes workspace switching, access control, middleware validation, subscription handling, and workspace-specific settings.
Asset Sharing ​
Comprehensive sharing system for digital assets, folders, and collages. Includes share link generation, embed codes, password protection, expiration dates, download restrictions, and public share views.
Access Control & Permissions ​
Role-based access control (RBAC) via the DAM_CAPABILITIES matrix in plugins/helper.js. Four roles: brand-portal-user, viewer, manager, admin. Includes portal visibility selection (replaces public/private), permission dialogs, middleware validation, and Vue.prototype helper functions.
Portals ​
Dedicated sidebar section for creating and managing brand portals. Portals determine which content is visible to external users — the "Portals" dialog on assets/folders/collages replaces the old public/private toggle.
Analytics & Insights ​
Comprehensive analytics and insights system for tracking user interactions, asset performance, and system usage. Includes event tracking, browser/location data collection, insights dashboards with weekly graphs, transaction logging, and subscription-based access control.
Adobe CC Integration ​
Specialized API endpoint for Adobe Creative Cloud applications to upload digital assets directly to the DAM system. Handles multipart chunked file uploads (10MB chunks), S3 storage operations, version uploads, and asset metadata management.
Feature Dependencies ​
Management Modules
↓
├── Role-Based Access
└── Sharing & Permissions
↓
└── AWS S3 Storage
Tags & Custom Fields
↓
└── Search & Discovery
↓
└── Typesense Search
Upload Flow
↓
└── AWS S3 StorageQuick Reference ​
| Feature | Primary Use Case | Key Components |
|---|---|---|
| Management Modules | Organize application features | Module registration, navigation |
| Tags & Custom Fields | Metadata management | Tag system, field definitions |
| Tag Management | Asset categorization | FileTagInput, TagsBox, AddTags, SearchBulkActions |
| Custom Fields | Workspace-specific metadata | CustomFieldItem, CustomFieldsSection, CustomFieldDialog |
| Search & Discovery | Find content across types | SearchBarTypeSense, SearchAssets, SearchFilter, Typesense API |
| Global Search | Unified search interface | SearchBar, result tabs, URL-driven state |
| Advanced Search Filters | Filter panel deep-dive | File type, tag, custom field, date, user filters |
| Folder Listing & Detail | Folder pages and navigation | Folders list page, folder detail page, breadcrumbs |
| Folder Management | Folder dialog operations | FolderDialog, FolderDialogListItem, CreateCollageDialog, PermissionDialog |
| Upload Flow | Add assets to system | AssetUpload, upload-chunk, uploadQueue mixin, S3 API |
| Typesense Search | Fast search backend | Collections, indexing service |
| AWS S3 Storage | Cloud storage | Multipart upload, presigned URLs |
| Asset Sharing | Share assets securely | Share links, embed codes |
| Role-Based Access | Access control | Roles, permissions, middleware |
| Notifications | User notifications | DamNotification, NotificationSetting, Badge counts |
| Announcements | Workspace announcements | AnnouncementDialog, announcementTable, Notification integration |
| Multi-Workspace | Workspace management | Workspace switcher, Middleware, currentWorkspace mixin, Settings pages |
| Asset Sharing | Asset sharing | ShareAssetDialog, AdvanceShareDialog, shareLinkListTable, Embed codes |
| Access Control | RBAC, portal visibility | DAM_CAPABILITIES matrix, Vue.prototype helpers, PermissionDialog (Portals), middleware |
| Portals | Brand portal management | dam/portals pages, CreatePortalDialog, PortalLogoEditDialog, portals.css |
| Analytics & Insights | Analytics tracking | Analytics store, dispatchAnalytics, InsightsGraph, InsightsTabGraph, Bar chart |
| Adobe CC Integration | Adobe CC upload API | /upload-asset endpoint, S3 multipart upload, Presigned URLs, Metadata upload |
Getting Started ​
To understand how these features work together:
- Start with Management Modules to understand the application structure
- Review Role-Based Access for permission system
- Explore Upload Flow and AWS S3 Storage for storage
- Learn about Search & Discovery and Typesense Search for discovery
- Understand Sharing & Permissions for collaboration