Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/PloutusLab/krafta-web/llms.txt

Use this file to discover all available pages before exploring further.

The creator dashboard at /creator/dashboard is the central workspace for every CREADOR account. It is protected by a server-side auth check that requires the CREADOR or ADMIN role — unauthenticated visitors or users with a CLIENTE or TALLER role are redirected to /creator. From the dashboard you can manage your store profile, publish design listings, monitor your earnings, and review payout history, all without leaving a single interface.

Store profile management

Your store profile controls the public identity of your storefront. The following fields can be edited from the Ajustes de Tienda tab:
FieldDescription
displayNameThe name shown at the top of your public storefront
slugThe URL identifier used in /creator/[slug]
bioA short description of your store and creative style
activeToggle that hides or shows your entire storefront
The store slug must be unique across all creators on the platform. It is lowercased and sanitized to only allow letters, digits, hyphens, and underscores. Your public URL is krafta.com/creator/[slug] — changing the slug changes that URL immediately, so update any external links accordingly.
Profile changes are persisted by calling PUT /api/users with the updated storeInfo payload. Bank account details for royalty transfers (via Pago Móvil or bank transfer) are entered in the same settings form under the Datos Bancarios para Regalías field. These details are required before automated monthly payouts can be processed.

Design management

The Mis Productos tab lists all of your published design listings. To add a new listing you first create a design through the canvas editor (/editor?mode=creator&productId=...) and then complete the three-step publish wizard:
  1. Choose a base product — select from the available product variants in the catalog (camisetas, hoodies, libretas, tazas, tarjetas, etiquetas).
  2. Design — place and transform your artwork on the product mockup in the canvas editor.
  3. Configure and publish — title your design, set a retail price, and choose a print provider workshop.
Each uploaded CreatorDesign starts with approved: false. The design will not appear on your public storefront until an admin reviews and approves it.

Listings and pricing

A CreatorDesignListing links an approved design (creatorDesignId) to a specific ProductVariant (variantId). When creating a listing you set the retailPrice — the price that customers pay. The dashboard includes a real-time royalty calculator that shows:
retailPrice − basePrice (production cost) = your royalty per unit
The system enforces a floor: submitting a retailPrice below the variant’s basePrice produces a validation error and the listing cannot be saved. Each listing also displays an auto-generated SKU derived from the listing title, product color, and size, for example:
MID-DIS-VEN-BLA-M
A listing is only visible on the public storefront when all four conditions are true:
  • Creator.approved is true
  • CreatorDesign.approved is true
  • CreatorDesignListing.active is true
  • ProductVariant.active is true

Earnings overview

Every time a customer purchases one of your listings, a CreatorEarning record is created and linked to the OrderItem. The Métricas tab surfaces a summary of your earning activity:
FieldDescription
orderItemIdThe order item that generated this earning
amountRoyalty earned on a single order item
statusPENDING (not yet paid out) or PAID (included in a payout)
payoutIdReference to the CreatorPayout that settled this earning, if any
The Métricas tab also displays estimated aggregate indicators (conversion rate, total visits, monthly bar chart) calculated from local listing data. These are approximations intended to give you a directional sense of performance and are not derived from live analytics.

Payout history

Pending earnings are batched into CreatorPayout records at the end of each month. Each payout record contains:
FieldDescription
creatorIdThe creator who received this payout
amountTotal amount transferred in this payout
referencePayment reference number (Pago Móvil or bank transfer)
receiptUrlLink to the transfer receipt stored in the private file bucket
paidAtTimestamp of when the payout was completed
Payouts are sent to the bank or Pago Móvil details configured in Ajustes de Tienda. If no bank details are saved, the dashboard displays a warning banner prompting you to add them before the next payout cycle.

Build docs developers (and LLMs) love