Developer & AI Agent Submission Guide

How to Submit to Build with Us

Everything you need to publish your product to the Next Level Builders directory — manually via Web Studio, from CLI pipelines, or autonomously with AI Agents.

4 Ways to Submit Your Product

1. Manual Web Builder (Zero Code)

Beginner Friendly
Open Builder Studio

Use our interactive visual builder to construct block documents, live preview, and submit directly from your browser.

Step-by-step Execution:
  • Visit the Builder Studio at /studio
  • Fill in product identity (Slug, Title, Tagline, Website URL, Logo)
  • Configure Hero, Media Gallery, Features Grid, and Tech Stack blocks
  • Click 'Save Draft & Revision' to generate a verified content hash
  • Review your live preview at /studio/products/[slug]/preview and click Submit

2. Developer CLI Package (@nextlevelbuilder/cli)

Automated & CI/CD
View NPM Package

Validate local JSON listings, compute canonical cryptographic content hashes, and publish directly from your terminal or deployment pipeline.

Step-by-step Execution:
  • Install CLI: npm install -g @nextlevelbuilder/cli
  • Validate listing: nlb validate ./nlb.product.json
  • Preview document: nlb preview ./nlb.product.json
  • Submit to directory: nlb submit ./nlb.product.json --api-key YOUR_API_KEY
  • Check status: nlb status <slug>

3. Model Context Protocol Server (MCP)

AI Native (Cursor / Claude / Codex)
Explore MCP Server

Connect our official MCP server to your AI IDE or agent runtime so AI tools can draft, format, and submit products autonomously.

Step-by-step Execution:
  • Add MCP server to your config (stdio or Cloudflare SSE):
  • Tools available: validate_listing, create_revision, submit_product, get_product
  • Prompt your AI: 'Draft a full 5-block product document for my repo and submit it to Next Level Builders directory'
  • The agent calls validate_listing then submit_product with your API credentials

4. Direct REST API Endpoints

Full Programmatic Control
Open Interactive Scalar API Docs

Integrate directly with our high-throughput OpenAPI 3.1 endpoints on Cloudflare Edge.

Step-by-step Execution:
  • POST /api/v1/products — Create product draft envelope
  • POST /api/v1/products/{slug}/revisions — Upload block document
  • POST /api/v1/products/{slug}/submit — Submit into moderation queue
  • GET /api/v1/products/{slug}/markdown — LLM-optimized structured feed

16 Supported Content Block Types

Every listing is represented as an immutable, validated JSON document containing any combination of these 16 blocks.

Hero Block

hero

Top headline, punchy subheadline, CTA button, and urgency badge.

Media Gallery Block

mediaGallery

Responsive 16:9 screenshot and video showcase with captions.

Grid Block

grid

1, 2, or 3 column cards for key capabilities, architecture, and benefits.

Tech Stack Block

techStack

Badges highlighting TypeScript, Next.js, Cloudflare, PostgreSQL, AI models.

Pricing Block

pricing

Tiers, billing cycles, feature checklists, and checkout links.

FAQ Block

faq

Accordion questions and answers for technical and business queries.

Live Demo Embed Block

liveDemo

Embedded iframe sandbox or interactive playground URL.

Call To Action Block

cta

High-contrast conversion banner with primary action button.

Founder Story Block

founder

Founder avatar, bio, Twitter/Discord links, and personal mission statement.

Milestones Block

milestones

Historical chronological timeline of major product achievements.

Roadmap Block

roadmap

Upcoming quarterly releases with status (planned, in_progress, shipped).

Changelog Block

changelog

Versioned release notes with semver tags and date stamps.

Quote / Testimonial Block

quote

Social proof quotes from verified community members.

Verification Claims Block

verification

Cryptographic proof, open-source repos, and revenue verification.

Case Study Block

caseStudy

In-depth customer implementation story with measurable ROI metrics.

Showcase Carousel Block

carousel

Interactive carousel slider for product gallery snapshots.

Ready to Launch Your Product?

Join the high-trust builder network. Get verified, track transparent votes, and gain organic distribution across our developer community.

Launch in StudioRead API Docs