marketplaces/docs/Project-Editor.md

Marketplace Project Editor - Sprint 13

Scope

Sprint 13 introduces first version of Marketplace Project Editor.

Editor only manages bootstrap configuration.

Out of scope:

• products
• categories
• orders
• analytics management

Architecture

src/app/features/project-editor/
  pages/
  components/
  sections/
  models/
  services/
  facade/

Editor uses strongly typed bootstrap models and isolated feature state. Components do not call APIs directly.

Facade API

ProjectEditorFacade exposes:

• loadBootstrap()
• updateBootstrap()
• exportBootstrap()
• importBootstrap()
• preview()

Current source of truth:

• existing bootstrap provider via ConfigService

Future backend integration:

• replace local import/export/save flow with builder endpoints
• keep component contracts unchanged

Supported Sections

• General
  • marketplace name
  • domain
  • description
  • default language
  • supported languages
• Branding
  • logo
  • small logo
  • favicon
  • marketplace title
• Theme
  • palette tokens via color pickers
• Header
  • logo/search/categories/languages/cart/profile/wishlist/compare/region toggles
• Footer
  • company information
  • address
  • phone
  • email
  • copyright
  • payment icons
  • social links
  • static pages
• Homepage
  • home page sections list
  • visibility
  • order
  • layout
  • drag-and-drop ordering
• Widgets
  • homepage widget configuration
  • typed shortcuts for hero/categories/product collection widgets
  • JSON fallback for other widget props
• Marketplace Features
  • feature flags
  • search suggestions/history
  • recently viewed
  • reviews/questions/recommendations
• Preview
  • export JSON
  • import JSON
  • runtime preview without full browser refresh

Preview Strategy

Preview updates bootstrap snapshot in memory and re-applies:

• theme
• branding
• runtime state
• route-based page rendering on next Angular navigation

This keeps bootstrap engine intact while enabling fast local preview.

Widget Configuration

Current widget editor supports explicit fields for:

• Hero
  • layout
  • height
  • overlay
  • autoplay
• Categories
  • layout
  • columns
• Product Collection
  • layout
  • cards per row
  • filters
  • badges
  • rating
  • price

Other widgets use JSON props fallback until dedicated editors are added.

Future Backend Endpoints

Recommended future builder endpoints:

• GET /builder/bootstrap
• PUT /builder/bootstrap
• POST /builder/bootstrap/preview
• POST /builder/bootstrap/validate
• POST /builder/bootstrap/import
• GET /builder/bootstrap/export

Constraints

• runtime bootstrap engine not replaced
• configuration stays source of truth
• no hardcoded marketplace values
• no business domain management mixed into editor