Skip to content

Designs Documentation

Designs are the primary creative artifact on Shona. Each design is a structured record of a garment or piece — from materials and motifs to the people who brought it to life. They are posted by profiles, not user accounts.

Posting a design

Posting a design happens in two stages. First, you fill out the core fields and publish — this creates the design record and makes it visible on your profile. Then, a set of enrichment sections unlocks for adding deeper detail. Each enrichment section saves independently, so you can build out the record over time.

The core fields

The core section must be completed and published before anything else unlocks. These fields form the public-facing identity of the design.

title

The name of the piece. Keep it descriptive but concise.

description

A narrative overview of the design — its purpose, aesthetic, and intent.

category

The garment category (e.g. dress, suit, accessory). Used for discovery and related-design grouping.

tags

Freeform keywords for searchability. Add as many as are genuinely relevant.

season

The collection season this piece belongs to, if applicable.

target_gender

Menswear, womenswear, unisex, or childrenswear. Affects filtering on the browse page.

images

At least one image is required. Upload multiple to provide full coverage of the piece.

screenshot — core design form showing required fields

  1. 1

    Navigate to your profile and select 'post a design'

    Designs are always posted under a specific profile. Make sure you have the right active profile selected in the profile switcher at the top of the editor.

  2. 2

    Fill in all required core fields

    Title, description, category, target gender, and at least one image are mandatory. Tags and season are optional but improve discoverability.

  3. 3

    Click 'publish design'

    This creates the design record on the platform and makes it visible on your profile's portfolio tab. The enrichment sections below the core form will unlock immediately.

  4. 4

    Enrich the design with additional detail

    Scroll down to the enrichment sections. Each one saves independently — you can add materials today, then come back to add motifs or link collaborators later.

The profile switcher at the top of the editor controls which profile the design is posted under. If you have multiple profiles, make sure you're on the right one before publishing — a design's creator profile cannot be changed after the fact.

draft designs

A design can be saved as a draft instead of published immediately. Drafts exist for one primary reason: building a collection. If you publish each piece as you finish it, followers see the collection taking shape piece by piece — there's no reveal. Drafts let you prepare every piece first and release the whole collection at once.

How draft designs behave

visibility

A draft design is only visible to its creator profile. It does not appear in feeds, search, or on the profile's portfolio tab.

enrichment

Draft designs support the same enrichment sections as published designs — materials, motifs, variations, inspiration, and collaborators can all be added before the piece ever goes public.

collection assignment

Draft designs can be added to a collection's lineup the same way published designs can. This is the core use case — build the full collection privately, then publish.

Publishing on collection release

When a collection containing draft designs is published, every draft design in its lineup is automatically published in the same action. You don't need to publish each piece individually — the collection's publish step takes care of it. Any design in the lineup that was already published beforehand is left as is.

A design can also be saved as a draft outside of a collection context — for example, if you want to finish enrichment before going live. But the feature was built specifically to support collection embargoes, so the collection-publish behavior above is the primary thing to know.

enriching a design

Once a design is published, five enrichment sections become available. These are all optional, but they're what separates a basic listing from a complete creative record. Each section saves independently via its own save button.

materials & techniques

Document every fabric used with percentage breakdowns and notes, plus the construction techniques applied. This data appears in the materials breakdown on the design detail page.

motifs

Record the patterns, symbols, and structural marks present in the piece — including their application method, cultural origin, placement, and colour palette.

variations & pricing

Add colourway variations with their own images, and publish indicative pricing ranges with labels and currency. Multiple ranges can coexist (e.g. wholesale vs retail).

inspiration & history

Write the creative context for the piece — what inspired it, its cultural references, and any provenance or historical background that informs the work.

stylists & models

Link the collaborators who worked on this design. Attribution can be general or scoped to a specific event context.

screenshot — enrichment sections below the core design form

Enrichment data is fully editable after publishing. Navigate to your design and click 'Edit' to return to the editor at any time. Only the design's owner profile can make edits.

status & licensing

Two fields — status and license type — communicate the current state of the design and the terms under which it can be reproduced or referenced. These appear on the design detail page and affect how buyers and collaborators interpret the work.

Production status

concept

The design exists as an idea or sketch. No physical or digital prototype has been produced yet.

digital prototype

A digital render or 3D model exists but no physical sample has been made.

physical sample

A physical sample has been produced and photographed.

production ready

The design has been finalised and is ready for manufacturing at scale.

License type

exclusive

The design is proprietary. Reproduction or referencing without express permission from the creator is not permitted.

rights managed

Use is permitted under specific terms negotiated with the creator. Contact the creator to discuss terms.

open source

The design is available for free use, adaptation, and redistribution, subject to attribution.

License type on Shona is a signal of intent, not a legally binding instrument. For formal IP protection, consult a registered IP attorney. See the attribution documentation for how Shona's graph helps establish provenance.

Linking stylists & models

The people section of the design editor lets you credit the stylists and models who worked on a piece. Attribution on Shona is context-aware — you can record a general cast that applies to the design at large, or scope credits to a specific event the design appeared in.

General cast vs event cast

General cast

Credits that apply to the design regardless of any specific event. Use this for the core team who produced the piece — the stylist who dressed it for the lookbook shoot, or the fitting model.

Event cast

Credits scoped to a specific event appearance — the models who walked it at a particular runway show, for example. Switch to an event context using the event search field at the top of the people section.

When crediting a model under the general cast (no event selected), at least one execution image is required before the profile search unlocks. This is a deliberate guardrail — a general-cast model credit with no visual proof of the piece being worn has no real record value. Up to two images can be attached per model credit. Stylist credits and event-scoped model credits do not require images.

screenshot — people section with event context switcher

  1. 1

    Open the people section in the design editor

    Scroll down to the 'Stylists & Models' enrichment section. It becomes available once the core design is published.

  2. 2

    Choose a context

    By default you are editing the general cast. To scope credits to a specific event, use the event search field to find and select the relevant event. The people section will switch into that event's context.

  3. 3

    Search and add profiles

    Use the stylist and model search inputs to find profiles on the platform. Only profiles with the matching role (stylist or model) will appear in each search. Adding a profile creates an appearance record linking their node to your design.

  4. 4

    Save the cast

    Click 'Update General Cast' or 'Update Event Cast' depending on which context you're in. Each context saves independently — switching to an event context and saving will only affect credits for that event.

When you link a model or stylist to your design, they can see that attribution from their own profile. Appearance records are visible on both the design detail page and the credited profile's page, building a relational record across the graph.

How credits appear on the design

On the public design detail page, stylists and models are listed with their profile photos and names. If a credit is event-scoped, the event name appears alongside the profile as context. General-cast credits have no event label.

screenshot — model and stylist credits on design detail page

Linking to events

Designs are linked to events through the appearance system — specifically through the event-scoped people credits described above. When a design has event-scoped appearances, those events automatically surface in the 'Event Provenance' section on the design detail page.

How the link is established

There is no separate "add to event" action. An event link is created automatically when you credit a stylist or model under an event context in the people section. The event appears in the design's provenance once at least one appearance record references it.

screenshot — event provenance section on design detail page

Event provenance serves as a record of where a design has been shown. A single design can carry appearance records from multiple events — a piece worn at Paris Fashion Week and Lagos Fashion Week will show both events in its provenance trail.

The event side of the link

From the event's perspective, designs that appeared in it are visible in the event's content sections. This creates a two-way relational record — you can navigate from a design to its events, or from an event to the designs shown there. See the Events documentation for how event cast is managed from the event side.

variations

The word "variation" covers two distinct things on Shona, depending on who's creating it. Understanding the difference matters — they live in different places, are owned differently, and serve different purposes.

Colourway variations

Added by the design's own creator, from the "Variations & Pricing" enrichment section. These are different colourways or fabric versions of the exact same piece — same design record, same owner, just documented with their own images and notes. They live and die with the parent design.

Variations by other designers

A separate, independently-owned design created by a different designer or fashion house, built off an existing published design as its creative source. This is a full design record in its own right — with its own title, images, and enrichment — that simply credits where it started from.

screenshot — colourway variations section vs variation attribution card

Creating a variation of someone else's design

From any design card or its detail page, the action menu offers "Create A New Variation" — available to designer and fashion house profiles, on any published design that isn't your own. This opens the standard design editor with the category pre-filled from the source, ready for you to build out as a genuinely new record.

  1. 1

    Open the action menu on a design you don't own

    Available from the design card in any feed, or from the design's own detail page. Only designer and fashion house profiles will see the option — models and stylists do not.

  2. 2

    Select 'Create A New Variation'

    This opens the design editor at a fresh, blank record — not a copy of the source design. Only the category is pre-filled for convenience.

  3. 3

    Build out the design as normal

    Title, description, images, and every enrichment section work exactly as they do for any other design. The variation link is the only thing that differs from a standalone post.

  4. 4

    Publish

    Once published, the design carries a permanent attribution card linking back to the design it was a variation of, and the original design's detail page gains an entry in its 'Variations by Other Designers' list.

You can't create a variation of your own design — attempting to will redirect you to that design's own editor instead, since editing your own work directly is the correct action there. Variations can only be built from designs that are currently published; drafts aren't eligible sources.

How the link appears

On the variation's own detail page, a small card near the top credits the original design and its creator, linking back to it. On the original design's detail page, a "Variations by Other Designers" section lists every design that was built from it, each shown with its own creator, image, and engagement counts — similar to how pieces are listed inside a collection.

Variation attribution is permanent once published — it cannot be changed or removed after the fact, and does not transfer any ownership, licensing rights, or editing access between the two designs. The variation is a fully independent design owned entirely by its own creator; the source design's owner has no control over it.

the provenance page

The design detail page itself only surfaces a minimal slice of a design's connections — enough for a quick read, not the full record. Every design also has a dedicated provenance page at /designs/[id]/provenance that expands this into three full, paginated lists: the looks it's appeared in, everyone who's worked on it, and every event it's shown at.

The three tabs

featured looks

Every look blueprint that has this design in its garment manifest. Pulled from the same platform-design links described in the Looks documentation.

creative direction

The full cast — every model and stylist credited on the design, across both general cast and every event-scoped context, combined into one list.

events provenance

Every event the design has appeared at, derived the same way as the design detail page's own provenance section — from event-scoped appearance records.

Each tab is its own independently paginated list, loading more entries as you scroll rather than all at once. This is what makes the provenance page suited to designs with a long history — a piece shown at a dozen events with dozens of credited models would be unwieldy to show in full on the main detail page.

screenshot — provenance page showing tabbed navigation and infinite list

The provenance page is purely a read view — it does not offer any editing actions. To change credits or event links, use the design editor's enrichment sections described earlier in this document.

visibility & discovery

Once published, a design is immediately visible on your profile's portfolio tab and indexed across the platform's browse and search surfaces.

Where designs appear

profile portfolio tab

All designs by a profile appear here, ordered by most recent. Followers land on this tab by default.

browse & category pages

Designs are indexed by category, tags, target gender, and season. The browse page supports filtering and search across all of these.

related designs

The bottom of each design detail page shows related pieces from the same category. Good category and tag hygiene improves the quality of related suggestions.

event provenance pages

If a design appeared in an event, it surfaces on that event's page — giving it visibility to audiences following the event.

screenshot — design card as it appears in browse and on profiles

Engagement signals

Designs accrue likes, saves, and comments. These signals are visible on the design card and detail page and are used to surface popular work across the platform. Followers who have enabled design notifications will receive a notification when you publish a new design.

Designs cannot be set to private or draft after publishing. If you need to remove a design from public view, you will need to delete it from the design editor. Deletion is permanent and removes all associated enrichment data, though appearance records linked to events are preserved.