Marketplace
The Marketplace is where you browse, install, and manage pre-built templates for your repository. Open it from the sidebar navigation.
Templates
There are two kinds of templates:
- Database templates — a complete database (or set of related databases) with schema, fields, views, and automation. Installing one creates a pull request that adds those files to your repository.
- Record templates — pre-filled field defaults for records in a specific database. Installing one makes that template available when creating new records.
Templates come from two tiers:
| Tier | Description |
|---|---|
| Premium | Multi-database bundles with cross-database relationships and GitHub Actions automation. Requires a paid plan. |
| Community | Open-source, single-database templates without GitHub Actions. Always free — contributions welcome. |
Browsing
The Marketplace has three tabs:
Databases
Database templates organized by tier — Premium on the left, Community on the right. Each card shows the name, description, version, and author. Click a card to open the detail page with the full README, a schema preview, and install controls.
Premium templates show a lock icon if your plan does not include them. Clicking a locked template prompts you to upgrade.
Records
Record templates organized the same way as Databases. Both tiers are always browsable regardless of plan. Each card shows the compatible database and description.
Installed
Shows two tables:
- Installed Databases — all database templates you've installed, with their current version, latest available version, and whether an update is available. Use the Check for updates button to refresh version status.
- Local Templates — record templates you've created yourself inside your repository (stored in
<database>/.templates/). These have a Local badge and can be edited or deleted from here.
Installing a database template
- Open the template detail page from the Databases tab.
- If your workspace has multiple connected repos, select the target repo.
- Click Install. Lightworks opens a pull request in your repository with all the template files.
- Review and merge the PR. The template is recorded in
.lightworks/installed.json.
Uninstalling a database template
From the template detail page, click Uninstall. Lightworks opens a pull request that archives the installed files rather than deleting them. Merge the PR to complete the uninstall.
Installing a record template
- Open the template detail page from the Records tab.
- Enter the target database ID (the folder name in your repo).
- Click Install. Lightworks opens a pull request adding the template file to your repository.
Once installed, the template appears in the New from template picker when creating records in that database.
New from template
When creating a new record in a database, click New from template to open the template picker. Templates are grouped into Local, Community, and Premium sections and can be searched by name or description. Selecting a template pre-fills the new record's fields with the template's defaults.
Updates
The Installed tab shows the pinned version (what you have) and the latest available version for each installed database template. Click Check for updates to fetch the latest versions from the template repositories. When an update is available, an amber badge appears — install the update by opening the template detail page and clicking Update.
The lockfile
Installed templates are tracked in .lightworks/installed.json at the root of your repository. This file records each template's ID, tier, installed version, latest known version, installation date, and the list of files it added. Do not edit this file manually.