Plugin
Plugin in the Cuppa ecosystem
Schema
| Property | Type | Required | Description |
|----------|------|----------|-------------|
| id | string (uuid) | ✓ | Unique identifier for the plugin |
| name | string | ✓ | Plugin name |
| identifier | string | ✓ | Plugin identifier (e.g., 'com.cuppa.auth') |
| description | string | ✓ | Brief description of the plugin |
| version | string | ✓ | Plugin version (semantic versioning) |
| author | string | | Plugin author or organization |
| category | enum | ✓ | Plugin category |
| icon_url | string (uri) | | URL to plugin icon |
| documentation | string | | Full documentation in markdown format |
| installation | string | | Installation instructions |
| platforms | string[] | | Supported platforms |
| dependencies | string[] | | Required plugin dependencies |
| repository_url | string (uri) | | URL to source code repository |
| downloads | integer | | Number of downloads |
| rating | number | | Average user rating |
| tags | string[] | | Tags for search and categorization |
| published_at | string (date-time) | | When the plugin was published |
| updated_at | string (date-time) | | When the plugin was last updated |
Example
{
"id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
"name": "CuppaAuth",
"identifier": "com.cuppa.auth",
"description": "Authentication plugin with OAuth, Sign in with Apple, and biometric support",
"version": "2.1.0",
"author": "Cuppa Team",
"category": "authentication",
"icon_url": "https://mycuppa.io/plugins/auth-icon.png",
"documentation": "# CuppaAuth\n\nA comprehensive authentication solution...",
"installation": "Add to Package.swift: .package(url: \"https://github.com/cuppa/cuppa-auth\", from: \"2.1.0\")",
"platforms": [
"ios",
"macos"
],
"dependencies": [
"CuppaCore"
],
"repository_url": "https://github.com/cuppa/cuppa-auth",
"downloads": 15420,
"rating": 4.8,
"tags": [
"auth",
"oauth",
"apple-sign-in",
"biometric"
],
"published_at": "2024-06-01T10:00:00Z",
"updated_at": "2025-11-01T14:30:00Z"
}
Enums
category
authentication | analytics | storage | networking | ui | utility | integration