Create a New Plugin App
This tutorial walks through creating a new Page plugin template in the Developer Hub. By the end you'll have a plugin with an auto-provisioned Git repository and a first draft version ready for development.
- You must have the Developer role on your team (see Add Developer Role)
- An SSH key must be added to your profile if you plan to clone the repo (see Create & Assign an SSH Key)
Time: ~5 minutes
Steps
1. Open the Developer Hub
From your team dashboard, click Developer Hub in the left-hand navigation.
2. Select Plugin Type
The Developer Hub shows tabs for each plugin type. For a full-page attendee app, select Pages.
If you're building a persistent overlay or analytics tracker, choose Widgets instead. For portal layout and styling, choose Themes. See Plugin Development Overview for a description of each type.
3. Click Create
Click the Create button (or + New Page) to open the plugin creation form.
4. Fill in Plugin Details
Complete the creation form:
| Field | Description | Example |
|---|---|---|
| Name | Display name shown in the dashboard | My Agenda App |
| Slug | URL-safe identifier, unique within your team | my-agenda-app |
| Description | Brief description of what the plugin does | Event schedule and session browser |
The slug must be lowercase, use hyphens instead of spaces, and be unique across all plugins in your team. It cannot be changed after creation.
5. Click Create
Click Create to provision the plugin template.
6. View Your New Plugin
You'll be taken to the plugin detail page. From here you can see:
- Versions tab — your first draft version (v1) has been created automatically
- Git Repository tab — your Gitea repository has been provisioned
- Settings — configure version assets, dependencies, and flags
7. Clone the Repository
Navigate to the Git Repository tab to find your clone URL.
Copy the SSH clone URL and run it from your terminal:
git clone ssh://git@git-ssh.eventfinity.app:2222/your-team/my-agenda-app.git
cd my-agenda-app
The SSH server uses port 2222. If you get a connection error, verify your SSH key is saved to your profile (see Create & Assign an SSH Key).
8. Install Dependencies and Build
The cloned repository includes a starter project. Install dependencies and run the local dev server:
npm install
npm run dev
Your plugin is now ready for development. Any push to main will trigger an automated build and upload the compiled assets to your draft version.
What's Next
- Git Repos & Build Pipelines — configure build settings, output paths, and collaborators
- DevKit Basics — set up the GxP DevKit for local development
- Create an All-Access Blank Project — create a project to install and test your plugin