skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
litiumab/agent-skills67 installs

litium-developer

Help Litium partner developers build, configure, and deploy e-commerce sites and backoffice UI extensions. Use for React Accelerator (Next.js, GraphQL, blocks, cart, checkout, wishlist), MVC Accelerator (.NET Razor views, controllers, view models, client builds), local setup, Litium Cloud deployment, data modelling and product fields, Litium Admin, Storefront GraphQL, Connect, and Extension Management APIs, or forum.litium.com solutions. Covers @litiumab/platform-extension-sdk extensions in React, Vue, Angular, or Vanilla: scaffolding, extension.manifest.json, window.litiumExtension, sub-path routing, IIFE/Vite builds, testing, installation, and deployment. Triggers: build Litium site, create Litium project, product field, block, accelerator, Litium API, wishlist, cart, placeOrder, custom field, backoffice extension, platform-extension-sdk, UI extension, panel, or settings page extension.

How do I install this agent skill?

npx skills add https://github.com/litiumab/agent-skills --skill litium-developer
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides comprehensive documentation and guidance for Litium platform developers. It covers environment setup, API usage, and UI extension development using standard developer tools and official Litium resources.

  • Socketwarn

    2 alerts: gptSecurity, gptAnomaly

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

Litium Developer

Overview

Partner developers building on Litium platform use this skill for implementation guidance. This skill delegates to the litium-cloud-cli skill for cloud deployment and to litium-cloud-migration for moving a site from Litium legacy cloud to Serverless Cloud. For all other Litium topics — including React Accelerator, MVC, data modelling, and APIs — it loads reference files on demand.

Always read references/partner-guidance.md first before helping modify Litium platform files.

Delegation

For this area, delegate entirely to the named skill — do not duplicate its content here:

TopicSkill to use
Litium Serverless Cloud operations: deploy, environments, apps and YAML manifests, artifacts, secrets, access control, backups and restore, custom domains, CI/CD with service principalslitium-cloud-cli
Migrate an existing site from Litium legacy cloud (Windows/IIS, Web Deploy) to Serverless Cloud: assessment, Linux-ready code changes, test environment from legacy backups, pipeline conversion, rehearsal and go-live runbook, MIGRATION.mdlitium-cloud-migration

Reference map

Read these files only when the user's task requires that area:

Reference fileLoad when the user asks about
references/partner-guidance.mdwhat partners can/cannot modify, correct extension patterns, internal API disclaimer, protected projects, NuGet feeds, Elasticsearch index separation
references/setup-empty-project.mdset up bare Litium, empty project, install bare platform, download Litium locally, litemptyweb template
references/setup-mvc-accelerator.mdinstall MVC Accelerator locally, litmvcacc template, yarn build, deploy accelerator in back office
references/setup-react-accelerator.mdinstall React Accelerator locally, litreactacc template, storefront proxy, .env.local, headless accelerator
references/setup-troubleshooting.mdsetup error, local environment issue, install fails, SQL connection, certificate, port conflict, package restore
references/mvc-accelerator.mdMVC development, .NET controller, Razor view, view model, webpack client build, MVC + React component, Elasticsearch MVC
references/data-modelling.mdcustom field types, create field type, field template, folder template, product template, multi-field, field not in template, FieldTypeMetadataBase
references/cart-and-wishlist.mdcart, checkout, order, wishlist, addVariantToCart, createCheckoutSession, placeOrder, CartContext, BuyButton, payment widget
references/apis.mdAdmin Web API, Storefront GraphQL API, Connect ERP API, Payment API, Shipment API, Extension Management API, OpenAPI spec
references/forum-api.mdsearch forum.litium.com, community solution, Discourse API, find forum post
references/react-accelerator/overview.mdReact Accelerator development, Next.js architecture, server vs. client components, GraphQL patterns, component conventions, testing
references/react-accelerator/template-routing.mdcreate page/product/category/block template, proxy routing, [[...slug]] catch-all, template naming conventions
references/react-accelerator/code-patterns.mdReact Accelerator code patterns, queryServer, mutateClient, service layers, fragments, Apollo Client usage
references/react-accelerator/project-structure.mdReact Accelerator directory layout, app/, components/, services/, operations/ folders
references/react-accelerator/graphql-sdl.mdfetch Storefront GraphQL SDL, schema download, RUNTIME_LITIUM_SERVER_URL, available operations
references/extension/cli-commands.mdscaffold new extension, create command, add command, dev command, @litiumab/platform-extension-sdk CLI
references/extension/manifest-reference.mdextension.manifest.json fields, targets, common.web-component, admin.menu-item, admin.settings-page, api.proxy, customElementTag, bundleUrl
references/extension/bridge-api.mdwindow.litiumExtension, navigate(), replaceUrl(), showNotification(), getContext(), on(), off(), routeChanged, contextChanged
references/extension/framework-patterns.mdCustom Element entry point, React extension, Vue extension, Angular extension, Vanilla extension, panel component, Admin Web API requests
references/extension/routing.mdsub-path routing, MemoryRouter, createMemoryHistory, MemoryLocationStrategy, sub-path attribute, routeChanged, deep link
references/extension/testing.mdunit testing extensions, mock window.litiumExtension, Vitest, Jest, @testing-library/react, @vue/test-utils
references/extension/deployment.mdinstall extension, enable extension, Extension Management API, bundleUrl, HTTPS, CDN, Settings > Extensions, IIFE bundle

Documentation search priority

  1. Primary: https://docs.litium.dev/ — always try first for official docs.
  2. Community: https://forum.litium.com/ — for real-world solutions; load references/forum-api.md to search programmatically.

Quick-start routing

Step 0 (always): Read references/partner-guidance.md first to understand what partners can/cannot modify.

  • "How do I work on the React storefront?" → read references/react-accelerator/overview.md first, then load specific references as needed (template-routing, code-patterns, etc.).
  • "How do I deploy/manage Litium Cloud environments?" → delegate to litium-cloud-cli.
  • "How do we move our site from legacy cloud to Serverless Cloud?" → delegate to litium-cloud-migration.
  • "How do I set up Litium locally?" → load the matching setup reference (empty / MVC / React).
  • "How do I add cart or wishlist functionality?" → load references/cart-and-wishlist.md.
  • "How do I create a custom field type or field template?" → load references/data-modelling.md.
  • "How do I call the Admin Web API or a Connect API?" → load references/apis.md.
  • "How do I build a backoffice UI extension?" → read references/extension/cli-commands.md first, then load specific references as needed (framework-patterns, bridge-api, routing, etc.).
  • "How do I add a panel or settings page to an extension?" → load references/extension/cli-commands.md (always use the CLI — never create files manually).
  • "How do I navigate or show notifications in an extension?" → load references/extension/bridge-api.md.

Backoffice UI Extension Architecture

Extensions are Web Components (Custom Elements) loaded as IIFE bundles. They run in complete isolation from the Angular 20 admin host — React, Vue, Angular, or Vanilla JavaScript all work. The host communicates with extensions exclusively through window.litiumExtension.

┌───────────────────────────────────────────────────────────┐
│  Litium Admin (Angular 20 host)                           │
│                                                           │
│  ┌─────────────────────────────┐                         │
│  │  <litium-ext-my-widget>     │  ← Custom Element       │
│  │                             │    (your extension)     │
│  │  ┌─────────────────────┐   │                         │
│  │  │   Your framework    │   │                         │
│  │  │   (React / Vue /    │   │                         │
│  │  │    Angular / Vanilla│   │                         │
│  │  └─────────────────────┘   │                         │
│  │            │               │                         │
│  │            ▼               │                         │
│  │  window.litiumExtension     │  ← Bridge API           │
│  └─────────────────────────────┘                         │
│              │                                            │
│  navigate() · showNotification() · getContext()           │
│  on('routeChanged') · on('contextChanged') · off()        │
└───────────────────────────────────────────────────────────┘

Extension Critical Rules

These rules MUST be followed in every extension. Violating them causes runtime failures.

Always Use the CLI — Never Create Files Manually

When scaffolding a new project, adding a panel, or adding a settings page, MUST use the @litiumab/platform-extension-sdk CLI (see references/extension/cli-commands.md). Do NOT manually create component files, manifest entries, or index imports — the CLI handles all three correctly.

Only write code manually inside the generated component files (implementing the UI logic).

Custom Element Tag Naming

  • All tags MUST start with litium-ext-
  • Pattern: litium-ext-{extension-id} for the main element
  • Panels: litium-ext-{extension-id}-panel-{slug}
  • Must match regex: /^litium-ext-[a-z][a-z0-9-]*$/

Guard customElements.define

if (!customElements.get('litium-ext-my-extension')) {
  customElements.define('litium-ext-my-extension', MyElement);
}

Cleanup Event Subscriptions

Always unsubscribe from window.litiumExtension.on() in disconnectedCallback / onUnmounted / ngOnDestroy. Failing to do so causes memory leaks.

Never Call navigate() Inside a routeChanged Handler

Creates an infinite loop. Only call navigate() in response to user actions.

Use Memory-Based Routing

Extensions must NOT call history.pushState directly. Use MemoryRouter (React), createMemoryHistory (Vue), or MemoryLocationStrategy (Angular).

NPM Registry Configuration

# .npmrc
@litiumab:registry=https://registry.npmjs.org/

Extension Quick Workflows

Creating a New Extension

  1. Read references/extension/cli-commands.md
  2. Ask the user which framework: react, vue, angular, or vanilla
  3. Run: npx @litiumab/platform-extension-sdk create <name> --framework <framework>
  4. cd <name> && npm install
  5. Read references/extension/framework-patterns.md for the chosen framework
  6. Start dev server: npm run dev
  7. Register in Litium via Settings > Extensions (see references/extension/deployment.md)

Adding a Panel / Settings Page

  1. Read references/extension/cli-commands.md
  2. From the extension project root, run npx @litiumab/platform-extension-sdk add panel or add settings-page
  3. The CLI generates the component file, updates the manifest, and injects the import
  4. For settings pages: add the route in the framework router (see references/extension/routing.md)

Building and Deploying

  1. Read references/extension/deployment.md
  2. npm run build — produces dist/extension.js
  3. Upload to a CDN or hosting server (HTTPS required for production)
  4. Update bundleUrl in extension.manifest.json
  5. Install via Settings > Extensions or POST to the Extension Management API

Extension Common Mistakes

SymptomRoot causeFix
403 Forbidden on admin API callsCalling /Litium/api/admin/ without a valid bearer tokenRequest an OAuth token with VITE_LITIUM_CLIENT_ID and VITE_LITIUM_CLIENT_SECRET, then send it in the Authorization header
Extension blank / not renderingCustom element tag mismatch between manifest and codeEnsure tag in customElements.define() matches customElementTag in manifest
Back button doesn't workUsing framework router instead of bridge APICall window.litiumExtension.navigate() for cross-boundary navigation
Infinite re-rendersCalling navigate() inside a routeChanged handlerOnly call navigate() in response to user actions
Hot-reload error: element already definedMissing customElements.get() guardWrap customElements.define() with the guard pattern
npm ERR! 404 Not Found for SDKMissing .npmrc registry configAdd @litiumab:registry=https://registry.npmjs.org/ to .npmrc
Deep links load root page insteadNot reading sub-path attribute on first renderRead getAttribute('sub-path') in connectedCallback
Stale context after channel switchCaching getContext() result foreverSubscribe to contextChanged event
Memory leak warnings on unmountNot unsubscribing from eventsCall the unsubscribe function in disconnectedCallback / cleanup hook

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/litiumab/agent-skills/litium-developer">View litium-developer on skillZs</a>