Creator Guide

Upload Wizard#

The upload process uses a 3-step wizard that guides you through everything:

Step 1: Upload Files

• Drag and drop your component files, or click to browse.
• Supported file types: .tsx, .ts, .jsx, .js, .css, .scss, .html, .vue, .svelte, and common image formats.
• Limits: 20 files max, 500KB per code file, 5MB per image, 10MB total.

Step 2: Add Metadata

• Title -- a clear, descriptive name (e.g. "Gradient Hero Section with CTA").
• Description -- explain what the component does, its features, and use cases.
• Category -- select the most appropriate category (Hero Sections, Navigation, Forms, etc.).
• Framework -- React, Vue, HTML, or Svelte.
• Styling -- Tailwind CSS, plain CSS, or SCSS.
• Tags -- add up to 10 relevant tags for discoverability.
• License -- choose MIT, Apache 2.0, GPL, or another open-source license.
• Dependencies -- list any npm packages required beyond the framework itself.

Step 3: Review & Submit

• Preview your component listing as it will appear in the gallery.
• Review all metadata for accuracy.
• Click Submit for Review to send your component to the moderation queue.

Metadata Best Practices#

Good metadata dramatically improves your component's discoverability and download count. Follow these guidelines:

Titles

• Be specific: "Animated Pricing Table with Toggle" is better than "Pricing Component".
• Include the component type: hero, card, form, modal, etc.
• Mention standout features: "responsive", "dark mode", "animated".

Descriptions

• Start with what the component does in one sentence.
• List key features (responsive, accessible, animated, etc.).
• Mention customization options (props, CSS variables, slots).
• Include typical use cases or pages where it fits.

Tags

• Use lowercase, hyphenated tags: dark-mode, responsive, animated.
• Include both general and specific tags: hero and hero-section.
• Add framework and styling tags even though they are separate fields -- it helps search.

Understanding Shortcodes#

Every published component gets a unique shortcode -- a compact identifier that can be used to reference, share, or import the component.

Shortcode format

chipakit:username/component-slug

For example:

chipakit:janedoe/hero-v1
chipakit:bobsmith/pricing-cards
chipakit:alexdev/dark-mode-toggle

Where shortcodes are used

• MCP imports -- tell your AI assistant to import a component by shortcode.
• Sharing -- include the shortcode in READMEs, documentation, or social media.
• API access -- resolve a shortcode to a full component via GET /api/v1/resolve/:shortcode.
• Component detail page -- the shortcode is displayed on every component page with a copy button.

Moderation Process#

All uploaded components go through a multi-stage moderation pipeline before appearing in the public gallery. This ensures safety and quality for everyone.

Pipeline stages

1. Automated security scan -- static analysis, dependency audit, malware detection, and behavioral analysis.
2. Quality assessment -- code quality metrics, TypeScript strictness, accessibility compliance, and bundle size checks.
3. Human review -- a moderator verifies content policy compliance, visual quality, and accurate descriptions.
4. Decision -- approved (published), rejected (with feedback), or changes requested.

Timelines

• Most components are reviewed within 24-48 hours.
• Verified creators with a strong track record may be reviewed faster.
• You will receive an email notification when a decision is made.

If your component is rejected

• You will receive specific feedback explaining what needs to change.
• Edit your component based on the feedback and resubmit.
• Resubmissions go through the same pipeline but are typically reviewed faster.

Managing Components#

Once published, you can manage your components from the Creator Dashboard (accessible from your profile menu).

Edit a component

• Update the title, description, tags, or metadata without resubmitting for review (minor edits).
• Upload new file versions -- this triggers a new moderation review.

Delete a component

• Soft-delete removes the component from the gallery and search results.
• Existing downloads on user machines are not affected.
• The shortcode is reserved permanently -- it cannot be reused.

View analytics

• See download counts, copy events, and MCP import counts per component.
• Track trends over time to understand which components are most popular.

Your Creator Profile#

Every creator has a public profile page at /creators/your-username. This page shows:

• Your avatar, display name, and bio.
• Total downloads across all components.
• A grid of all your published components.
• Links to your GitHub, website, or social profiles (if configured).

Edit your profile from Settings > Profile to add a bio, avatar, and social links.