statamic-cms

name: statamic-cms description: Use when working with Statamic 6 features in this project — creating or modifying collections, entries, blueprints, fieldsets, taxonomies, globals, navigations, assets, forms; running the please CLI; configuring the Control Panel or SEO Pro; or anything under content/, resources/blueprints/, or config/statamic/. Statamic-specific concepts that are not covered by the generic Laravel skills. metadata: version: "1.1.0" domain: cms triggers: Statamic, collection, entry, blueprint, fieldset, taxonomy, global, navigation, please, control panel, cp, antlers, statamic tag, seo pro, form, page builder

Statamic CMS (this project)

Statamic 6.x (currently 6.21) with Pro enabled. This is a Laravel package, so all Laravel conventions still apply — but content management has its own model. Read [[statamic-eloquent-driver]] first when touching content: this project stores content (and users) in MySQL, not flat files. When writing or editing any copy, follow [[content-voice]]: wording must read human-written (no em-dashes, no AI constructions).

This is the site build for Aligned Life — Melissa Alexander's hypnotherapy practice (RTT). Primary CTA everywhere: "Book a Free 15-Minute Discovery Call" (URL from the site_settings global).

What's enabled in .env

If a feature isn't working, check the env var before debugging code.

Content model

Pages seeded: Home /, About Melissa /about, Hypnosis & RTT /hypnosis-rtt, Services /services, Resources /resources, Contact /contact.

Navs: main (About, Hypnosis & RTT, Services, Resources, Contact) and footer — trees reference page entries.

Global set: site_settings — contact_email, contact_phone, booking_url (currently /contact placeholder), facebook/instagram/youtube/tiktok URLs, footer_tagline. Blueprint at resources/blueprints/globals/site_settings.yaml. (A footer disclaimer field existed until 2026-06-12; removed at Ryan's request — template block, blueprint field, and value all deleted. Don't reintroduce it as a "fix".) Handles as of 2026-06-12: instagram_url is @thealignedlife.w.melissa; youtube_url stays the @alignbmcenergy business channel (free-audio embeds link @FreeRTTHypnosisAudios-b6h directly instead — deliberate split, per Ryan).

Form: contact (name, email, phone, enquiry) with honeypot field website. The message field handle is deliberately enquiry, not message — message is a reserved word in Statamic's form email context. All fields carry max-length rules (name 120, email 254, phone 30, enquiry 5000) — keep bounds on any new field. No email config yet (mail is log locally); submissions are stored in DB and visible in CP → Forms. Covered by tests/Feature/ContactFormTest.php (happy/validation/max/honeypot), which loads the real committed blueprint.

Asset container: assets → public/assets disk. Contains 8 images registered as eloquent assets with alt text: og-default.jpg (load-bearing for social sharing — do not delete or rename without updating resources/addons/seo-pro.yaml), two real photos of Melissa for the home and About page image+text sections (portrait-melissa.jpg, portrait-melissa-about.jpg — replaced the placeholders 2026-06-12; outdoor autumn shoot, 1463×2048), plus placeholder images covering: home hero (hero-home.jpg), CTA background (cta-forest-path.jpg), Hypnosis & RTT page (rtt-calm-space.jpg), and two article covers (cover-overthinking.jpg, cover-hypnosis-audios.jpg). No service images (explicitly declined). Glide image presets configured in config/statamic/assets.php: sm (640px), md (1024px), lg (1600px), xl (2400px) — all webp q80. Use {{ partial:img }} for all asset rendering (see [[antlers-templating]]).

Blueprints & fieldsets

• Reusable fieldsets in resources/fieldsets/: seo (seo_title, seo_description, og_image — imported into every entry blueprint), page_builder (the replicator with all sets), faq_items (the faqs grid, shared between the service blueprint and the faq replicator set via field reference faq_items.faqs).
• Page-builder replicator sets: hero, text, image, cta, comparison, services_grid, testimonials_slider, youtube_embed (optional more_url/more_label browse link under the embed), faq, steps, trust_strip, image_text, programs (package cards: title, duration badge, description, includes list). CTA/hero button label + URL fall back to the discovery-call default and site_settings.booking_url in the partials. The hero subheading supports inline markdown for a serif name accent (the homepage emphasises Melissa Alexander this way; see [[antlers-templating]]). cta has an optional image field (full-bleed photo variant when set). image_text fields: image, image_side (left/right), eyebrow, heading, text (markdown), checklist, optional button (renders only when both label and url present).
• Canonical blueprint YAML in v6 is tabs: → (named tab) → sections: → fields:. Hand-written legacy sections: maps are accepted and auto-migrated on import, but exports rewrite to tabs: — author new blueprints in tabs format to keep diffs clean.

SEO Pro

statamic/seo-pro (^7.10) is installed. {{ seo_pro:meta }} renders all meta in the layout head. Site defaults live in addon settings (DB) — snapshot at resources/addons/seo-pro.yaml:

• title {{ seo_title ?? title }}, description {{ seo_description ?? excerpt ?? intro }} — i.e. the custom seo fieldset feeds defaults, entry titles are the fallback. Don't put "| Aligned Life" in seo_title values; the site name is appended automatically (| separator, configured as site_name_separator in resources/addons/seo-pro.yaml).
• Default social image: image: og-default.jpg wired in the site defaults. config/statamic/seo-pro.php is published with assets.container = 'assets' so Glide can process the image. og-default.jpg must exist in public/assets and be registered as an asset — do not rename without updating both places.
• Per-collection inject cascade: pages and services collections use inject: { seo: { image: '@seo:og_image' } } (falls back to the site default og image); articles use inject: { seo: { image: '@seo:cover_image' } } (resolves from the entry's cover_image field). This @seo:field source syntax preserves the Asset object — do not replace it with an Antlers expression (SEO Pro's Cascade casts those to string and the meta template then receives a string, not an Asset, breaking the <meta property="og:image"> tag).
• Sitemap at /sitemap.xml (testimonials excluded via inject.seo: false), humans.txt enabled, JSON-LD organization + breadcrumbs.
• Per-entry overrides exist in the injected "SEO" tab on publish forms (stored in the entry's seo array) — prefer the custom fields, use the injected tab only for canonical/robots edge cases.

The please CLI

Statamic's own CLI lives at the project root: php please <command> (not php artisan). Discover commands with php please list. Most relevant groups:

• eloquent:* — import/export between DB and flat files. Prefer composer content:export for snapshots. See [[statamic-eloquent-driver]] for the gotchas (no --force on import-entries, stale URI columns, stache clearing).
• make:* — scaffold tags, fieldtypes, modifiers, addons, widgets, scopes, actions (e.g. app/Modifiers/YoutubeEmbedUrl.php came from make:modifier).
• stache:* — stache:clear after any direct DB or flat-file change.
• auth:migration — generated the statamic user columns + role_user/group_user + webauthn migrations (already run; users table uses uuid ids).

php artisan is still used for Laravel things (migrations, routes, tinker, tests, pail).

Control Panel

• URL: /cp (under https://alignedlife.test/cp), login ryan@mortier.ca (super).
• Revisions are on: publishing flows through working copies on pages/services/articles/testimonials.
• Built with Inertia.js + Vue 3 — extending the CP means php please setup-cp-vite.
• Dashboard widgets live in config/statamic/cp.php (widgets): a welcome panel (template → resources/views/widgets/welcome.blade.php), the built-in form widget on contact ("New Enquiries"), collection widgets for articles and testimonials, SEO Pro's seo_pro report, and updater. Statamic 6 ships collection/template/updater/form; SEO Pro adds seo_pro and recent_errors. An unregistered handle 500s the dashboard, so check app('statamic.widgets')->keys() before adding one. Blade (html()) widgets inject raw markup into the Inertia dashboard: wrap content in <ui-widget title="…"> for card chrome and avoid app Tailwind utilities (purged from the CP build), using inline styles + currentColor for theme safety. Covered by tests/Feature/DashboardWidgetsTest.php.

When this skill is wrong

Update this file whenever:

• A new env var is flipped in .env
• A collection, taxonomy, blueprint, fieldset, global, nav, or form is created/renamed
• SEO Pro defaults change meaningfully
• A custom tag/fieldtype/modifier/addon is added under app/

References

• Statamic docs: https://statamic.dev/ (append .md to most doc URLs for raw markdown, e.g. https://statamic.dev/content-modeling/collections.md)
• LLM-targeted docs index: https://statamic.dev/llms.txt
• SEO Pro docs: vendor/statamic/seo-pro/DOCUMENTATION.md
• Boost search-docs tool is weak for Statamic specifics — prefer the .md doc URLs or vendor source