A modern WordPress block theme built with Full Site Editing (FSE) capabilities for fishing and outdoor adventure websites. This theme provides comprehensive features for managing fish species, gear, fishing areas, and adventure content, built following LightSpeedWP organization standards.
# Clone the repository
git clone https://github.com/lightspeedwp/fishing-theme.git
cd fishing-theme
# Install dependencies
npm install
composer install # Optional, for PHP linting
# Start development
npm start
# Run tests
npm testπ Full Development Setup Guide β
Full Site Editing (FSE) with comprehensive theme.json configuration
Custom Post Types for Fish Species, Gear, and Fishing Areas
Block patterns and template parts for rapid fishing content development
Comprehensive testing with Playwright and accessibility checks
WordPress coding standards enforcement via automated linting
Performance optimized for Core Web Vitals
SEO & Accessibility Optimized - WCAG 2.2 AA compliant
This theme is specifically designed for fishing and outdoor adventure websites featuring:
- Fish Species Management: Custom post type with detailed species profiles, habitats, and seasonal information
- Fishing Gear Catalog: Organize and showcase fishing equipment and accessories
- Fishing Areas: Document and share information about fishing locations and areas
- Blog Integration: Share fishing stories, tips, and educational content
- Taxonomy System: Species, habitats, seasons, gear types, and area categories
- Responsive Design: Mobile-first design optimized for field use
- π SEO Excellence: Comprehensive meta tags, structured data
- βΏ Accessibility: WCAG 2.2 AA compliant with zero axe-core violations
- β‘ Performance: Core Web Vitals optimized with lazy loading
- π§ͺ Testing: Automated accessibility and performance testing with Playwright
- π± Responsive: Mobile-first design with progressive enhancement
- π οΈ Developer-Friendly: Built following LightSpeedWP coding standards
This theme extends the WordPress Twenty Twenty-Five theme with:
Fishing-specific features and custom post types Custom color palette and typography optimized for outdoor/adventure content Accessibility-first approach (WCAG 2.2 AA compliance) Performance optimization and modern build tools Organization compliance with LightSpeedWP standards
WordPress 6.8+ with Full Site Editing (FSE) Node.js 18+ and npm for build tooling @wordpress/scripts for development workflow Sass/SCSS for stylesheets with PostCSS processing Playwright for end-to-end and accessibility testing
VS Code with WordPress-optimized configuration WordPress Studio or LocalWP for local development GitHub for version control and collaboration Compliance with LightSpeedWP standards
Coding Standards - Following WordPress Coding Standards and LightSpeedWP guidelines Automated Testing - Playwright for E2E and accessibility validation Code Quality - PHPCS, ESLint, and Stylelint enforcement Documentation - Comprehensive inline docs and README files per LightSpeedWP docs standards
βββ π .github/ # GitHub workflows and organization compliance
β βββ agents/ # Specialized development agents
β βββ chatmodes/ # Extended development workflows
β βββ instructions/ # Coding standards & best practices
β βββ prompts/ # Reusable development templates
β βββ workflows/ # CI/CD automation
βββ π .vscode/ # VS Code configuration
β βββ extensions.json # WordPress development extensions
β βββ settings.json # WordPress-optimized editor settings
βββ π inc/ # Theme includes
β βββ cpt-fish.php # Fish species custom post type
β βββ cpt-gear.php # Gear custom post type
β βββ cpt-area.php # Fishing areas custom post type
β βββ taxonomies.php # Custom taxonomies
β βββ block-styles.php # Custom block styles
βββ π patterns/ # Block patterns for content creation
βββ π parts/ # Template parts (header, footer, etc.)
βββ π templates/ # Block templates for FSE
βββ π styles/ # Theme style variations
βββ π e2e/ # Playwright end-to-end tests
βββ π src/ # Source files (SCSS, JS)
βββ SECURITY.md # Security policy and reporting
βββ CONTRIBUTING.md # Contribution guidelines per LightSpeedWP standards
βββ CODE_OF_CONDUCT.md # Community standards
βββ CHANGELOG.md # Release history
βββ LICENSE # GPL-3.0 license
βββ SUPPORT.md # Support policy
See CHANGELOG.md for a complete release history and notable changes.
This project is maintained by the LightSpeedWP organization and follows all organizational standards.
- LightSpeedWP (organization)
- Ashley Shaw (LightSpeed) (profile)
- Fork the repository and create a feature branch
- Follow WordPress and LightSpeedWP coding standards (automated linting enforced)
- Reference: Coding Standards
- Reference: Custom Instructions
- Write tests for new functionality (Playwright for E2E, PHPUnit for PHP)
- Update documentation for any new features or changes
- Submit a pull request with clear description and issue references following LightSpeedWP PR guidelines
- π Documentation: Check DEVELOPMENT.md for technical setup
- π Issues: Create GitHub issues for bugs or feature requests
- π¬ Community: WordPress.org forums and Slack communities
- π’ Organization: Follow LightSpeedWP standards
Use the provided issue templates in .github/ISSUE_TEMPLATE/:
- π Bug Report - Report functionality issues
- β¨ Feature Request - Suggest new features
- π Documentation - Request or improve documentation
- β‘ Performance - Report performance issues
- βΏ Accessibility - Report accessibility concerns
All documentation follows LightSpeedWP organization standards:
- Security Policy
- Contributing Guide - References LightSpeedWP Contributing Guidelines
- Code of Conduct
- Changelog
- License - GPL-3.0-or-later
- Support Policy
- License: GPL-3.0-or-later (see LICENSE)
- Base Theme: Twenty Twenty-Five by WordPress.org
- Organization: Built following LightSpeedWP standards
- Typography: Abel and Raleway from Google Fonts
- Testing: Powered by Playwright
Built with β€οΈ for the WordPress fishing and outdoor adventure community