Coding and configuration conventions for Velocity Stack development.

File Organization

All theme files include a header block documenting filename, full path, and integration dependencies (CSS, JS, server-side includes).

Responsive Breakpoints

T-shirt sizing for consistency across Editions:

/* XS: Mobile (default, <600px) */
/* S: Tablet (600px-900px) */
@media (min-width: 600px) { }
/* M: Laptop (900px-1200px) */
@media (min-width: 900px) { }
/* L: Desktop (1200px-1800px) */
@media (min-width: 1200px) { }
/* XL: Widescreen (>1800px) */
@media (min-width: 1800px) { }

CSS Naming

BEM-style naming for component classes: doc-nav (block), doc-nav__pages (element), doc-nav--collapsed (modifier).

Primary Typeface Usage

Self-hosted font files with preload hints. Weights limited to 400 (regular) and 700 (bold). Font-display: swap for performance.

Version Control Conventions

Semantic versioning for templates: MAJOR.MINOR.PATCH. Commit messages reference Work Tracking item numbers. Feature branches merged via pull request.