skills/vendix-frontend-theme/SKILL.md
Frontend theme and branding patterns: ThemeService, CSS variables, tenant branding, user theme presets, RGB variables, browser guards, and deprecated theme APIs. Trigger: When styling/theming frontend UI or working with branding configuration.
npx skillsauth add rzyfront/vendix vendix-frontend-themeInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
apps/frontend/src/app/core/services/theme.service.tsapps/frontend/src/app/core/models/tenant-config.interface.tsapps/frontend/src/styles.scssThemeService applies tenant branding plus user theme presets. Current presets include default, aura, monocromo, and glass.
The service generates CSS variables and RGB variants for dynamic alpha usage. It includes browser/SSR guards; do not access document directly from random services/components.
Use variables instead of hardcoded colors:
--color-primary, --color-secondary, --color-accent--color-background, --color-surface--color-text-primary, --color-text-secondary, --color-text-muted--color-border exists globally in styles, but backend branding transform does not currently map border_color.
Use ThemeService.transformBrandingFromApi() for API snake_case to frontend branding shape. Do not duplicate transform logic in components.
Deprecated APIs such as applyTheme() and transformThemeFromApi() should not be used in new code.
var(--color-*) with sensible fallbacks for reusable UI.ThemeService.vendix-ui-uxvendix-frontend-componentvendix-app-architecturedevelopment
Mobile app development rules for Vendix Expo/React Native project. Trigger: When editing, creating, or modifying any file under apps/mobile, or when developing mobile-specific features.
development
Feature gating by store subscription state: global store write guard, AI feature gate, Redis feature resolution, quota consumption, frontend paywall interceptor, banner, and subscription UI states. Trigger: When adding feature gates, paywalls, subscription-based access control, protecting store write operations, AI feature gates, or rollout flags.
testing
SaaS subscription billing for Vendix stores: plan pricing, invoices, Wompi platform payments, manual payments, partner commissions, payouts, proration, and dunning. Trigger: When creating SaaS invoices, working with partner rev-share, margin/surcharge pricing, invoice sequence allocation, partner payout batches, subscription payments, manual payments, or dunning flows.
development
Periodic quota counters with Redis, UTC period keys, Lua-based idempotent AI quota consumption, request-id deduplication, and post-success consumption. Trigger: When building quota counters, enforcing monthly/daily feature caps, or reusing AI quota patterns for uploads, emails, exports, or rate-limited features.