Skip to content
ɳSelf Docs

Template Marketplace

Template Marketplace

Section titled “Template Marketplace”

Templates are full-stack app packages you can install in one command. Each one includes a Postgres schema, Hasura metadata, seed data, and an optional Flutter starter app.

Browse at nself.org/templates or from the CLI.

Install a template

Section titled “Install a template”
Terminal window
nself init --template saas-starter ./my-app

The CLI downloads the template from the registry, verifies the SHA256 checksum, and extracts it into ./my-app. Then install the required plugins and start:

Terminal window
cd my-app
nself plugin install auth notify cms
nself start

Browse available templates

Section titled “Browse available templates”
Terminal window
nself template list
nself template list --category saas
nself template list --free
nself template info saas-starter
Section titled “Paid templates”

Some templates cost a one-time fee. They require an active ɳSelf+ license:

Terminal window
nself license set nself_pro_<your-key>
nself init --template marketplace-starter ./shop

Template manifest

Section titled “Template manifest”

Every template ships a template.yml at its root:

slug: saas-starter
display_name: SaaS Starter
description: Multi-tenant SaaS with billing, auth, and dashboard
version: "1.2.0"
price_usd: 0
category: saas
required_plugins:
  - auth
  - notify
  - cms
preview_url: https://saas-starter-demo.nself.org
cli_min_version: "1.0.9"

Update a template

Section titled “Update a template”

After installing a template, apply incremental schema migrations when the template author releases an update:

Terminal window
nself template update --dry-run   # preview pending migrations
nself template update              # apply additive migrations
nself template update --force      # allow destructive migrations (with confirmation)

Publish your own template

Section titled “Publish your own template”

Package your project as a template and earn 80% revenue share on paid templates.

  1. Create template.yml at your project root.
  2. Build the tarball:
Terminal window
tar -czf dist/my-template.tar.gz schema/ metadata/ seed/ flutter/
  1. Validate and prepare for submission:
Terminal window
nself template publish --tarball dist/my-template.tar.gz
  1. Complete submission at nself.org/developers/templates.

Free templates are MIT licensed and approved within 1 business day. Paid templates go through a manual review (1–3 days) and require a KYC-approved author account.

Categories

Section titled “Categories”
CategoryExamples
saasMulti-tenant apps with billing and auth
marketplaceTwo-sided marketplaces with seller payouts
socialCommunity forums, family networks, chat apps
productivityTeam tools, task managers, dashboards
mediaMedia servers, IPTV, podcast platforms
ecommerceProduct catalogs, shopping carts, order management
Section titled “Related”