A web application for developers to manage plugins in the Vultisig ecosystem.

• Plugin Management: Register, view, and edit plugins
• Team Collaboration: Invite team members with role-based access control
• API Key Management: Create and manage API keys for plugin authentication
• Earnings Dashboard: Track plugin earnings and transaction history
• Secure Authentication: Vultisig wallet integration with EIP-712 signatures

• Node.js 18+
• npm or yarn
• Vultisig browser extension (for authentication)

# Install dependencies
npm install

# Start development server
npm run dev

The app will be available at http://localhost:5173

Create a .env file in the project root:

VITE_API_BASE_URL=http://localhost:8080

src/
├── api/           # API client and endpoint functions
├── components/    # Reusable UI components
├── context/       # React Context definitions
├── hooks/         # Custom React hooks
├── icons/         # SVG icon components
├── layouts/       # Page layout components
├── pages/         # Route page components
│   ├── AcceptInvite.tsx
│   ├── Earnings.tsx
│   ├── NewPlugin.tsx
│   ├── PluginEdit.tsx
│   └── Plugins.tsx
├── providers/     # Context providers
├── storage/       # Local storage utilities
├── styles/        # Global SCSS styles
├── toolkits/      # Core UI primitives
└── utils/         # Utility functions and types

The portal uses Vultisig wallet authentication:

1. Connect your Vultisig wallet via the browser extension
2. Sign a message to authenticate
3. Receive a JWT token for API access
4. Token is automatically included in all API requests

Admins can invite team members via magic links:

1. Navigate to a plugin's edit page
2. Scroll to "Team Members" section
3. Click "Invite Member"
4. Select a role (Editor or Viewer)
5. Share the generated link (valid for 8 hours, single use)

Invited users:

1. Open the invite link
2. Connect their Vultisig wallet
3. Accept the invitation

Admins can create API keys for plugin authentication:

1. Navigate to a plugin's edit page
2. Find the "API Keys" section
3. Click "Create New Key"
4. Optionally set an expiry date
5. Copy the key immediately (shown only once)

API keys can be:

• Enabled/disabled via toggle
• Deleted (immediately expired)

All plugin metadata changes require EIP-712 signatures:

1. Make changes to plugin fields
2. Click "Save Changes"
3. Review the changes in the signing modal
4. Sign with your Vultisig wallet
5. Changes are submitted to the backend

This ensures an auditable trail of who made what changes.

npm run dev        # Start development server
npm run build      # Build for production
npm run preview    # Preview production build
npm run typecheck  # Run TypeScript type checking
npm run lint       # Run ESLint
npm run lint:fix   # Run ESLint with auto-fix

• TypeScript strict mode
• ESLint with React hooks plugin
• Automatic import sorting

• Use Stack, HStack, VStack for layouts
• Use $style prop for inline styles (not style)
• Access theme colors via useTheme() hook
• Use .toHex() method on color tokens
• Use Ant Design components for forms and modals
• Use custom Button component for actions

The portal communicates with the Vultisig Verifier backend:

• Base URL: Configured via VITE_API_BASE_URL
• Authentication: JWT Bearer token in Authorization header
• Content Type: application/json

Proprietary - Vultisig