podverse/podverse-web-patterns
.cursor/skills/web/SKILL.md
Common patterns and examples for the podverse-web Next.js application
$ install --global
skillsauthnpx skillsauth add podverse/podverse podverse-web-patternsInstall 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: Apr 16, 2026, 10:48 PM5.4s10 files scanned
SKILL.md
- name:
- podverse-web-patterns
- description:
- Common patterns and examples for the podverse-web Next.js application
- version:
- 1.1.0
Podverse-Web Development Patterns
This skill provides quick reference for common patterns used in the podverse-web application (apps/web/). Use these patterns when implementing new features or modifying existing code.
Monorepo Context
- Web app location:
apps/web/ - Helper packages (from
packages/helpers*/):@podverse/helpers- Core utilities, types, DTOs@podverse/helpers-validation- Validation utilities@podverse/helpers-requests- API request utilities@podverse/helpers-backend- Backend utilities (not typically used in web)@podverse/helpers-browser- Browser utilities@podverse/helpers-config- Config validation (not typically used in web)
- API client: Uses helper package DTOs and types
- Environment files:
apps/web/env/ - Translations:
apps/web/i18n/originals/en-US.json
Table of Contents
The patterns are organized into the following subject areas:
- Component Patterns - Pages, Client Components, Modals, Lists, Contexts, Server/Client split
- API & Data Fetching - API endpoint calls, SSR patterns, error handling
- Styling - SCSS Modules patterns
- Configuration - Environment variables, constants, config object, User-Agent patterns
- Code Quality - Error handling, type safety, translations
- Development Workflow - Plan mode vs Agent mode, documenting improvements
- Reusable Utilities - When to use @podverse/helpers
- Best Practices - Quick reference checklist and critical requirements
- Performance Optimization - Code splitting, memoization, image optimization, caching, monitoring
Quick Start
For the most critical patterns, see:
- Best Practices Summary - Quick reference checklist
- Translation Requirements - CRITICAL: Always use translations
- Component Patterns - How to create pages, components, modals, lists
- Configuration - Environment variables and constants
Pattern Files
01-component-patterns.md
- Creating a New Page with SSR
- Creating a Client Component with Translations
- Creating a New Context Provider
- Adding a New Modal
- Creating a New List Component
- Server/Client Component Split Pattern
02-api-data-fetching.md
- Adding a New API Endpoint Call (Client & Server patterns)
- API error handling
03-styling.md
- Styling with SCSS Modules
- SCSS file structure patterns
04-configuration.md
- Using Constants Instead of Hardcoded Values
- Environment Variables and Configuration
- Using Config Object Instead of process.env
- Environment Variable Validation
- Updating .env Files
- User-Agent String Pattern
Lighthouse Alignment
When web env validation changes (apps/web/scripts/validate-env.ts), update
tools/web-perf/lighthouse/.env.web.example and .env.web so Lighthouse stays aligned.
05-code-quality.md
- Error Handling (Catch Block Pattern, API Error Handling)
- Type Safety with podverse-helpers
- Translation Pattern
06-development-workflow.md
- Code Improvement and Optimization Guidelines
- Plan Mode vs Agent Mode
- Documenting Out-of-Scope Improvements
07-reusable-utilities.md
- When to Put Utilities in @podverse/helpers
- Pattern: Moving Utilities to @podverse/helpers
08-best-practices.md
- Best Practices Summary (Quick Reference Checklist)
- Translation Requirements (CRITICAL)
09-performance-optimization.md
- Performance Optimization Principles
- Code Splitting Patterns
- Memoization Patterns (React.memo, useMemo, useCallback)
- Image Optimization Patterns
- Data Fetching Optimization
- Rendering Optimization
- Bundle Optimization
- Performance Monitoring
- Common Anti-Patterns
Related Skills
- Bundle Optimization — Keep bundle size in mind when adding deps, changing helpers, or adding heavy UI.
Related Skills
podverse/podverse-workers-patterns
documentation
VerifiedTrustedCommunity
Per-job env validation and config patterns for the workers app. Use when adding or changing worker commands, touching workers startup validation, or documenting worker env vars.
4SKILL.mdUpdated Apr 16, 2026
podverse/time-format-local
tools
VerifiedTrustedCommunity
Ensures client-side time displays use formatDateTimeAbbrev for localized, readable timestamps. Use when rendering dates/times in the UI or when the user mentions time formatting or local timezone display.
4SKILL.mdUpdated Apr 16, 2026
podverse/.cursor/skills/testing-policy
testing
VerifiedTrustedCommunity
--- name: podverse-testing-policy description: Skip test implementation unless the user explicitly asks. Use when a plan or task includes adding unit tests, a test phase, or "Phase 3: Tests". version: 1.0.0 --- # Testing policy — skip tests for now ## When to use - When a plan or task includes adding unit tests, a test phase, or "Phase 3: Tests". - When deciding whether to implement tests for a feature. ## Rules 1. **We are not concerning ourselves with tests at this time.** Skip test imp
4SKILL.mdUpdated Apr 16, 2026
podverse/styles-import-last
development
VerifiedTrustedCommunity
Enforces import ordering so styles (CSS/SCSS module) imports are last. Use when editing React components or pages in .tsx/.jsx files, or when the user mentions import order or style imports.
4SKILL.mdUpdated Apr 16, 2026