rzyfront/vendix-calculated-pricing
skills/vendix-calculated-pricing/SKILL.md
Standardize calculated prices with taxes/fees: persist base/snapshot values only, calculate product final_price on reads, and keep tax-inclusive values out of create/update payloads. Trigger: When working with pricing that includes taxes/fees, UI price displays, or backend price calculations.
$ install --global
skillsauthnpx skillsauth add rzyfront/vendix vendix-calculated-pricingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: May 16, 2026, 5:05 AM173.9s1 file scanned
SKILL.md
- name:
- vendix-calculated-pricing
- description:
- >
- Standardize calculated prices with taxes/fees:
- persist base/snapshot values only,
- payloads. Trigger:
- When working with pricing that includes taxes/fees, UI price displays,
- license:
- MIT
- author:
- rzyfront
- version:
- 2.0
- scope:
- [root]
- auto_invoke:
- When working with pricing that includes taxes/fees, creating UI components for pricing, or implementing price calculations
Vendix Calculated Pricing
Core Rule
Do not persist calculated display prices for products. Persist base/sale inputs and tax assignments; calculate final display price on read.
Current product API uses final_price for calculated tax-inclusive responses. Do not standardize new code on price_with_tax unless the existing endpoint/interface already uses that name.
Product Pattern
- Persist:
base_price,cost_price,profit_margin,is_on_sale,sale_price. - Persist variant override:
product_variants.price_override. - Persist tax links:
product_tax_assignments. - Calculate:
final_price = effectiveBase * (1 + sum(taxRates)). - Effective base uses
sale_pricewhenis_on_saleis true and sale price is valid.
Snapshot Exception
Orders, invoices, payments, refunds, and accounting documents can store totals because they are historical transaction snapshots. Those amounts must not change if product prices or tax rates change later.
Frontend Display
- Calculated prices are read-only UI values.
- Label them as calculated/final values when user input could be confused with persisted price.
- Use the custom Vendix currency pipe/service for display.
DTO/API Rules
- Create/update DTOs should not accept
final_priceor equivalent calculated fields. - Read responses may include
final_pricefor convenience. - If an API returns both stored and calculated values, name them clearly.
Related Skills
vendix-product-pricingvendix-currency-formattingvendix-date-timezonefor historical timestamp semantics
Related Skills
rzyfront/mobile-dev
development
VerifiedTrustedCommunity
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.
5SKILL.mdUpdated May 29, 2026
rzyfront/vendix-subscription-gate
development
VerifiedTrustedCommunity
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.
5SKILL.mdUpdated May 16, 2026
rzyfront/vendix-saas-billing
testing
VerifiedTrustedCommunity
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.
5SKILL.mdUpdated May 16, 2026
rzyfront/vendix-redis-quota
development
VerifiedTrustedCommunity
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.
5SKILL.mdUpdated May 16, 2026