Everything for developers, with the step-by-step videos, is on one page: Developers.
BizPlug's plug-ins are open: their packages, the card's themes and layouts, and the list of industries are in a public repository on GitHub, msg2ai/bizplug-plugins. You contribute there, with a pull request that adds one file or one folder. You need a GitHub account and Node.js 18 or later; no BizPlug account, no keys and no server of your own, except for a plug-in you host yourself.
| To add | You add | The guide | Once it is merged |
|---|---|---|---|
| A card theme: five colours for a business's card | themes/<id>.json | THEMES.md | Listed in the marketplace within about fifteen minutes; offered on every business's plug-in when it is one of the three featured themes, otherwise once a business adds it |
| A new industry: a plug-in for a kind of business, on one of the five engines | community/industries/<slug>.json | INDUSTRIES.md | The file is the industry: its plug-in, its page here and its place in the portal go live with the website's next build |
| A menu layout: how the card's menu is drawn | community/layouts/<id>/ | LAYOUTS.md | Listed in the marketplace within about fifteen minutes, with you as its author; offered on every business's plug-in when it is one of the three featured layouts, otherwise once a business adds it |
| A plug-in of your own: an MCP server you host | community/plugins/<name>/ | CONTRIBUTING.md | Listed in the marketplace within about fifteen minutes; a business that adds it asks the BizPlug team to set it up with its plug-in |
Every command, with a video for each, is in Add a card theme, a menu layout and a new industry, step by step.
The steps
- 1Read the guide for what you are adding. It has the format, the rules and an example to copy.
- 2Fork the repository on GitHub and create a branch, for example
theme/harbourorindustry/bicycle-shops. - 3Add only your file or folder, in the place the table names. Everything else in the repository is generated, and a pull request that changes it fails its checks.
- 4Run the check for your kind of contribution from the root of your copy, and fix what it reports. The guide gives the command.
- 5Open a pull request against
main. It starts with a checklist: keep the part for your kind of contribution and paste the check's output. - 6The same checks run on the pull request, and the BizPlug team reviews it there and may ask for changes.
- 7When it is merged, it stays in the repository under your name. For an industry, a comment on your pull request tells you when it is live, with its page and its plug-in address.
npx tsx themes/check-theme.ts themes/<id>.json npx tsx industries/check-industry.ts community/industries/<slug>.json npx tsx layouts/check-layout.ts community/layouts/<id>
A new industry
First check that no existing industry fits. An industry is a kind of plug-in, not a business: every business that uses one gets its own plug-in with its own name, services, prices and colours. A yoga studio uses Fitness & Gyms and a vegan restaurant uses Restaurants & Food Service; neither needs a new industry. Propose one only when what its customers do, or the words of the plug-in, would be wrong in every existing industry.
An industry is one JSON file: its name and group, the engine it runs on (ordering, booking by date, appointments, quotes or tracking a request), the names of its three tools, a sample customer question and what the plug-in covers. It may also carry the words of its page on this site and a worked chat example; without them the page uses the engine's general words.
While your pull request is open, a workflow builds your industry as a working plug-in for a sample business at https://mcp-test.bizplug.ai/plugin/proposal/<pull request number>, tests it and comments the result. You can add that address in ChatGPT developer mode and try it. A sample business never sends a request.
An industry added this way uses an existing engine as it is. If it needs something no engine does, such as a new tool or a new data file, propose it with the issue form instead: that is built by the BizPlug team.
Everything your file says must be true of the plug-in: it answers from a business's published profile and sends requests the business confirms. It does not check live availability or take payment in the chat.
How you are credited
Your contribution is credited to the author you write in your own file, and once it is live you are listed on the contributors page. The credit also shows where businesses meet your work: on the industry's page, next to your theme in the portal, and next to your layout on Menu layouts.
| Field | In a theme or industry file | In a layout's `layout.json` |
|---|---|---|
| Your name or your company's (required) | author | author.name |
| A link of your own, https (optional) | authorUrl | author.url |
| Your GitHub username (optional) | github | author.github |
These fields are public, like the rest of the file and the pull request. Give only what you want shown; BizPlug looks nothing else up about you.
Not on GitHub?
Use a form instead and the team adds the file for you: propose a card theme, a menu layout or a new industry. For a plug-in of your own, use the marketplace form. Questions: info@bizplug.ai.
Contributions are published under the repository's MIT License. Pull requests and issues are public: never put customers' personal data, passwords or keys in one.
Last reviewed 22 November 2026