Marketplace

The NetPad Marketplace is a public catalog where you can discover, share, and install packages. Browse packages created by the community or publish your own.

Package Types

The marketplace offers three distinct types of packages:

Package Type	Description	Contents
Applications	Complete solution bundles	Forms + Workflows + Connections + Configuration
Forms	Standalone form definitions	Single form with fields, validation, and styling
Workflows	Automation templates	Workflow definitions with nodes and triggers

Applications (Primary)

Applications are the primary and most comprehensive package type. They represent complete, ready-to-deploy solutions that bundle everything needed for a specific use case:

Forms: All forms associated with the application
Workflows: Automation workflows that process form data
Connections: Form-to-workflow triggers and integrations
Configuration: Settings, themes, and customizations
Releases: Versioned snapshots with semantic versioning (X.Y.Z)

Applications are ideal when you need a complete solution—for example, a Customer Portal application that includes intake forms, approval workflows, and notification triggers all working together.

Forms

Standalone forms are individual form definitions that can be imported independently:

Single form with all field configurations
Validation rules and conditional logic
Theming and branding settings
No workflow dependencies

Forms are ideal when you need a specific form type (like a survey, registration form, or feedback form) without the accompanying automation.

Workflows

Standalone workflows are automation templates that can be imported independently:

Workflow definition with node configurations
Trigger configurations (form submission, webhook, schedule, etc.)
Node connections and data mappings
No specific form dependencies

Workflows are ideal when you need a specific automation pattern (like email notifications, data sync, or approval routing) that can be connected to your existing forms.

Browsing the Marketplace

Accessing the Marketplace

Navigate to Marketplace in the sidebar
Browse packages by type and category
Use search to find specific packages
Filter by source (web marketplace or npm packages)

Filtering by Package Type

The marketplace provides clear filtering options to find exactly what you need:

All Packages: View everything available
Applications: Complete solution bundles (featured first)
Forms: Standalone form definitions
Workflows: Automation templates

Applications are prominently displayed at the top of the marketplace, as they represent the most comprehensive and immediately useful packages.

Search and Filter

Text Search: Search by name, description, tags
Type Filter: Applications, Forms, or Workflows
Category Filter: Filter by package category
Source Filter: Web marketplace or npm packages
Official Filter: Show only official NetPad packages
Tags: Filter by package tags

Package Details

Viewing Package Details

Click on a package to see:

Overview: Description and key features
Screenshots: Visual previews
Contents: What's included (forms, workflows, etc.)
Requirements: Dependencies and prerequisites
Installation: How to install and set up
Documentation: Usage instructions
Reviews: User reviews and ratings
Version History: Available versions

Package Metadata

Each package includes:

Name: Package name
Type: Application, Form, or Workflow
Description: What it does
Category: Package category
Tags: Searchable tags
Author: Who created it
Version: Current version
License: License information
Source: Official or Community

Publishing to the Marketplace

You can publish any of the three package types to the marketplace. There are two publishing methods:

Web UI Publishing - Publish directly from the NetPad interface (easiest)
npm Publishing - Publish as an npm package for developer distribution

Type	Publish From	npm Keyword
Application	Application detail page	`netpad-app`
Form	Form editor menu	`netpad-form`
Workflow	Workflow editor menu	`netpad-workflow`

Quick Start: Publish a Form

Open your form in the Form Builder
Click the menu icon (⋮) → "Publish to Marketplace"
Fill out name, description, category, and tags
Add screenshots
Click "Submit for Review"

That's it! Platform admins will review and approve your form.

Full Publishing Guide

For detailed information on package formats, npm publishing, and best practices:

📖 Complete Publishing Guide →

The guide covers:

Package formats for Applications, Forms, and Workflows
package.json and bundle.json structure
CLI commands for creating and publishing packages
The review process and approval criteria
Managing published packages

Installing Packages

Installing Applications

Browse the marketplace and find an application
Click "Import"
Select target project
Configure connections and customize settings
Application is ready to use with all forms and workflows

Installing Forms

Browse forms in the marketplace
Click "Import"
Select target project (or application)
Form is added and ready for customization

Installing Workflows

Browse workflows in the marketplace
Click "Import"
Select target project (or application)
Connect triggers to your forms
Workflow is ready for execution

From npm

Install packages directly from npm registry:

# Install an application
npm install @netpad/customer-portal

# Using NetPad CLI
npx @netpad/cli install @netpad/customer-portal

Dependency Resolution

When installing packages:

Automatic Dependencies: Dependencies installed automatically
Version Compatibility: Checks version compatibility
Conflict Resolution: Handles dependency conflicts
Installation Log: Shows what was installed

Official vs Community

Official Packages

NetPad-verified packages:

@netpad/ Scope: Official package scope
Verified: Reviewed and verified by NetPad team
Supported: Official support available
Quality: Meets NetPad quality standards

Community Packages

User-created packages:

Various Scopes: Different npm scopes
Community Support: Community-provided support
Varied Quality: Quality varies by author
Open Source: Often open source

npm Package Integration

Package Discovery

NetPad automatically discovers packages:

Keyword Search: Searches npm for netpad-app, netpad-form, netpad-workflow
Scope Support: Supports @netpad/ and community scopes
Background Sync: Keeps marketplace up-to-date
Manual Sync: Trigger sync via API

Package Structure

NetPad packages include:

package.json: Standard npm package.json with NetPad metadata
Package Type: application, form, or workflow
Package Metadata: Name, description, version, category, tags
Dependencies: Application, plugin, workflow template dependencies
Configuration Schemas: Setup configuration schemas
Bundle Content: Application bundle, form definition, or workflow definition

Publishing to npm

Generate Package: Create npm-ready package from your content
Package Metadata: Add NetPad-specific metadata including type
Bundle Export: Include complete bundle
Publish: Publish to npm registry

Best Practices

For Publishers

Choose the Right Type:
- Use Application for complete solutions with forms + workflows
- Use Form for reusable form templates
- Use Workflow for reusable automation patterns
Complete Metadata: Fill out all fields including type
Good Screenshots: Show the package in action
Clear Documentation: Explain how to use and customize
Test Before Publishing: Ensure everything works
Maintain: Keep packages updated
Respond to Feedback: Engage with users

For Users

Filter by Type: Use type filters to find exactly what you need
Start with Applications: For complete solutions, look at applications first
Review Before Installing: Check requirements and documentation
Test in Dev: Test in development environment first
Customize: Adapt to your needs
Report Issues: Report bugs or suggest improvements
Review: Leave reviews to help others

Next Steps

Publishing Guide - Detailed guide on publishing packages
Applications - Learn about applications
Projects - Organize packages in projects
Developer Packages - Use CLI and packages

Package Types​

Applications (Primary)​

Forms​

Workflows​

Browsing the Marketplace​

Accessing the Marketplace​

Filtering by Package Type​

Categories​

Search and Filter​

Package Details​

Viewing Package Details​

Package Metadata​

Publishing to the Marketplace​

Quick Start: Publish a Form​

Full Publishing Guide​

Installing Packages​

Installing Applications​

Installing Forms​

Installing Workflows​

From npm​

Dependency Resolution​

Official vs Community​

Official Packages​

Community Packages​

npm Package Integration​

Package Discovery​

Package Structure​

Publishing to npm​

Best Practices​

For Publishers​

For Users​

Next Steps​