Documentation is work in progress and not completeEditor

Marketplace Overview

Digital Distribution Platform for Creative Assets

1. What is the Marketplace?

The marketplace is a digital distribution platform for creative motion graphics and video production assets. It serves two audiences: creators who upload and sell their work, and users who browse, search, and download content.

It supports three distinct content types:

Content TypeFile Format(s)Description
Marketplace Assets.ffxAnimation templates and effects
Projects.ffxprojFull project files with multiple scenes
3D Assets.blend, .fbx, .obj, .gltf, .c4d, .ma3D models and elements

2. How the Home Feed Works

When no category is selected, the main page displays a curated set of horizontal content rows, each populated by a recommendation engine. Each row shows 6 items. Items shown in one row are never repeated in another.

Row TypeDescription
"For You" rowsPersonalized rows for authenticated users, based on category interaction history. Up to 3 rows, one per top-interacted category. Requires at least 5 interactions within the last 30 days to activate.
Trending rowItems with the highest recent download momentum, measured as a ratio of recent vs. lifetime download count.
Newest rowItems created within a 14-day recency window.
Popular rowMost-downloaded items older than 48 hours.
Top 3 Category rowsFull breakdowns for the 3 categories with the most content on the platform.
Discover Something New rowFully randomized items for serendipitous discovery. Ignores scoring entirely.

3. Recommendation Scoring Algorithm

Every item is scored using a composite formula with three weighted factors. Items in curated rows are drawn from the top 25% scorers, with the remaining slots filled from a mid-tier exposure pool to give good content a chance at visibility. The Discover row ignores scoring entirely and is fully random.

FactorWeightCalculation Method
Recency35%Exponential decay with a 14-day half-life
Downloads45%Logarithmic scale based on lifetime download count
Momentum20%Ratio of recent 7-day downloads to total lifetime downloads

4. Categories and Filtering

The marketplace organizes content into distinct category sets per content type. The left sidebar shows all categories with item counts.

4.1 Marketplace Asset Categories

12 categories apply to Marketplace Assets (.ffx files):

Asset Categories
Text KitsTransitions
Logo AnimationsUI Animations
InfographicsLower Thirds
HUD & TechSocial Media
BackgroundsIcon Animations
Explainer GraphicsVideo Overlays

Projects and 3D assets each have their own dedicated category sets separate from the asset categories above.

4.2 Filtering Options

FilterOptionsApplies To
PriceAll, Free, PaidAll content types
SortPopular, Newest, Top-RatedAll content types
Render EngineBlender, Maya, C4D, and others3D assets only
Loop ReadyToggle on/off3D assets only

6. Asset Detail Modal

Clicking any item opens a detail modal that presents the full context and metadata for an asset. The modal is the primary point of interaction for viewing, evaluating, and downloading content.

SectionContents
Image CarouselUp to 5 images per asset, browsable within the modal.
Core InfoTitle, author, category, rating, download count, and price.
DescriptionFull long-form description as entered by the creator during submission.
Tags and MetadataAll associated tags and structured metadata fields.
3D-Specific FieldsFor 3D assets only: render engine, polygon count, loop-ready status, and supported file formats.
Action ButtonDownload or Get Asset button, which initiates the appropriate flow for free or paid items.

7. Upload / Submission (Create Template Wizard)

A 6-step modal wizard guides creators through the submission process. The wizard includes a progress indicator, back/continue navigation, and an unsaved changes warning when attempting to close mid-submission.

StepLabelDescription
1TitleName the template.
2Asset TypeChoose file type: .ffx, .ffxproj, or a 3D format.
3CategorySelect from the categories relevant to the chosen asset type.
4MediaUpload up to 9 images. The first image is required and serves as the thumbnail.
5DescriptionLong-form description used in search indexing and the asset detail display.
6PricingToggle Free or Premium. If Premium is selected, enter a price in USD.

8. Download and Purchase Flow

All downloads are logged with the item ID, item type, user ID, and timestamp. This data feeds both the recommendation engine and creator analytics.

Flow TypeSteps
Free ItemsDirect download. Download counter is incremented and the event is logged to the user's download history.
Paid ItemsGoes through a purchase flow. A purchase record is created containing the price and timestamp. The download counter is then incremented and the event is logged.

9. Creator Dashboard

The Creator Dashboard is accessible at /dashboard and provides creators with visibility into their uploads, performance metrics, and account settings. It is organized into three sections.

9.1 Submissions

FeatureDescription
Grouped by TypeAll uploaded items are listed and grouped by type: Assets, Projects, and 3D.
Item SummaryEach item displays its thumbnail, title, category, price badge, download count, and upload date.
DeleteA delete button triggers a confirmation modal that warns the creator that previous downloaders will retain their copy of the file.

9.2 Analytics

FeatureDescription
Date Range SelectorFilter analytics by: 7 days, 30 days, 90 days, or All Time.
Summary CardsFour headline metrics: Total Downloads, Total Purchases, Total Views, and Total Revenue.
Downloads ChartSVG line chart showing downloads over time with a per-item legend.
Views ChartSVG line chart showing views over time with a per-item legend.
Purchases ChartSVG bar chart showing purchases over time. Only shown if the creator has at least one premium item.
RevenueRevenue figures and the purchases chart are only displayed for creators who have published premium items.

9.3 Account

The Account section contains profile information and settings, as well as an account deletion option for creators who wish to permanently remove their account and associated data.

10. Data Models

The three content types each have their own data shape, but share a common set of base fields. Extended fields apply only to the content type that requires them.

10.1 Common Fields (All Content Types)

FieldDescription
idUnique identifier for the item.
titleDisplay name of the asset.
categoryCategory the item belongs to.
authorCreator who submitted the item.
ratingAggregated user rating.
download countTotal number of times the item has been downloaded.
priceNumeric price in USD, or "free".
thumbnailPrimary preview image.
tagsArray of keyword tags used in search and discovery.
creation dateTimestamp of when the item was first published.

10.2 Extended Fields — Projects

FieldDescription
difficulty levelSkill level required to work with the project.
scene countNumber of scenes contained in the project file.
durationTotal playback length of the project.
software requirementsAny software versions or plugins required to use the project.

10.3 Extended Fields,3D Assets

FieldDescription
render engineThe renderer the asset was built for (e.g. Blender, Maya, C4D).
polygon countTotal number of polygons in the 3D model.
file formatsAll available file format variants included in the download.
loop readyBoolean indicating whether the asset is designed as a seamless loop.

10.4 User Interaction Tracking

User interaction is tracked across five event types, all tied to authenticated user accounts. This data drives the recommendation engine and creator analytics.

Event TypePurpose
Category interactionsPowers the "For You" personalized feed rows.
Download logsRecords every download with item ID, item type, user ID, and timestamp.
View logsTracks when users open the asset detail modal.
Purchase recordsStores price, timestamp, and item details for paid transactions.
RatingsUser-submitted star ratings used in sort and display.