Digital Handbook

Appearance

CHBFoundation.com ​

CHB Foundation website built with WordPress using the Roots ecosystem (Bedrock + Fir Theme + Trellis) and custom Pinecones ACF block system.

Billing ​

Hosting Platform ​

Current Hosting Details ​

  • Provider: TBD
  • Plan: TBD
  • Server Location: TBD
  • SSL Certificate: TBD

Domain Management ​

  • Domain: chbfoundation.com
  • Local Development: chbf.test
  • Registrar: TBD
  • DNS Provider: TBD
  • CDN: TBD

Technical Stack ​

  • Framework: WordPress with Roots Bedrock boilerplate
  • Theme: Fir Theme (based on Roots Sage)
  • Templating: Laravel Blade templating engine
  • Build System: Bud.js with multi-compiler setup
  • Backend: PHP 8.1+, WordPress 5.9+, Laravel Acorn
  • Frontend: Vue.js components, modern CSS
  • Database: MySQL (managed by Bedrock)
  • Deployment: Trellis (Ansible-powered deployment)
  • Development Server: http://localhost:3000 (proxy to chbf.test)
  • Backup Strategy: TBD

Project Info ​

Project Details ​

  • Project Start Date: TBD
  • Launch Date: TBD
  • Current Status: Production
  • Last Updated: TBD

Client Contact Information ​

  • Primary Contact: TBD
  • Email: TBD
  • Phone: TBD
  • Role: TBD

Project Team ​

  • Project Manager: TBD
  • Developer(s): TBD
  • Designer: TBD
  • Content Manager: TBD

Notes ​

Development Notes ​

  • Architecture: WordPress with complete Roots stack (Bedrock + Sage + Trellis)
  • Custom Framework: Fir theme with custom Pinecones ACF block system
  • Block System: Each Pinecone contains PHP class, Vue component, Blade view, CSS, and JS
  • Build Process: Multi-compiler Bud.js setup (frontend, admin, editor)
  • Asset Loading: Dynamic Pinecone asset discovery and loading
  • Environment Requirements: PHP >= 8.1, Node.js >= 16, WordPress >= 5.9

Development Commands ​

  • Dependencies: yarn install && composer install
  • Development: yarn dev (hot reloading)
  • Production Build: yarn build
  • Block Management: yarn pinecone:make [name], yarn pinecone:remove [name]
  • Code Quality: composer lint (PSR12 standards)
  • Theme Diagnostics: yarn dr

Content Updates ​

  • Content Management: WordPress admin with ACF Pro
  • Block System: Custom Pinecones for flexible page building
  • Update Schedule: TBD
  • Maintenance: TBD
  • Change Log: TBD

Client Feedback ​

  • Revisions: TBD
  • Communication Notes: TBD

Performance Notes ​

  • Metrics: TBD
  • Optimization: Production builds separate Pinecone assets for optimal loading
  • Build System: Multi-compiler setup for admin, editor, and frontend
  • Monitoring: TBD

Third Party Services ​

Analytics & Tracking ​

  • Google Analytics: TBD
  • Google Tag Manager: TBD
  • Heatmap Tools: TBD

Email Services ​

  • Email Provider: TBD
  • Marketing Platform: TBD

Security Services ​

  • Security Monitoring: TBD
  • Malware Protection: TBD

Performance & Monitoring ​

  • Uptime Monitoring: TBD
  • Performance Tools: TBD

Website Features ​

Custom Block System (Pinecones) ​

  • Location: fir/Pinecones/[BlockName]/
  • Components: PHP class, Vue.js App, Blade template, CSS, JS, admin styles
  • Management: CLI tools for creating, removing, importing, and updating blocks
  • Auto-discovery: Build system automatically finds and compiles block assets

WordPress Configuration ​

  • Environment-based: Development, staging, production configs
  • Plugin Management: Composer-managed plugins
  • Advanced Custom Fields Pro: Included as must-use plugin
  • Custom Post Types: Located in fir/CustomPostTypes/

Build System Features ​

  • Multi-compiler: Separate builds for frontend, admin, and editor
  • Asset Discovery: Automatic Pinecone asset inclusion
  • Development Mode: All assets bundled together
  • Production Mode: Individual entry points per Pinecone
  • Hot Reloading: Development server with live updates

Framework Utilities ​

  • Helper Classes: fir/Lib/Utils/ for blocks, images, API calls
  • WordPress Integration: fir/Inc/ for hooks, AJAX handlers, cleanup
  • Custom Functionality: PSR-4 autoloaded classes in app/ directory

Technical Specifications ​

Development Environment ​

Directory Structure ​

site/                           # Bedrock WordPress root
├── web/app/themes/fir-theme/   # Fir theme
├── web/wp/                     # WordPress core
├── composer.json               # PHP dependencies
└── config/                     # Environment configs

trellis/                        # Ansible deployment
├── deploy.yml                  # Main deployment playbook
├── server.yml                  # Server provisioning
└── group_vars/                 # Environment-specific configs

Key Configuration Files ​

  • bud.config.mjs: Build system configuration
  • fir.config.json: Pinecone system configuration
  • wp-cli.yml: WP-CLI path configuration
  • composer.json: PHP dependencies and autoloading
  • package.json: Node.js dependencies and scripts

Credentials / Keys ​

Hosting & Domain Access ​

  • Domain Registrar: TBD
  • Hosting Provider: TBD
  • DNS Management: TBD

Development Credentials ​

  • Repository Access: TBD
  • Server Access: Trellis/Ansible managed
  • Database: Environment-based configuration

Third Party Service Credentials ​

  • Analytics: TBD
  • Email Services: TBD
  • CDN: TBD

APIs & Integrations ​

  • WordPress REST API: Available for content management
  • Custom AJAX Handlers: Located in fir/Inc/

Security Access ​

  • WordPress Admin: TBD
  • Server Access: SSH keys managed by Trellis
  • SSL Certificate Management: TBD

Security Note: All credentials and sensitive information should be stored securely using the agency's approved password management system. Environment variables are managed through Bedrock's environment-based configuration and should never be committed to version control.