# Dev Guides

> AI-friendly atomic decision guides for Drupal, CSS, JavaScript, design systems, and Next.js development. 1242 guides across 68 topics. Each topic link below points to a topic index with a routing table to individual guides.

## Drupal

- [AI Content](https://camoa.github.io/dev-guides/drupal/ai-content/): 12 guides — AI Content - AI-powered content creation, optimization, and management using Drupal AI module
- [AJAX to HTMX Migration](https://camoa.github.io/dev-guides/drupal/ajax-htmx-migration/): 17 guides — AJAX to HTMX Migration — pattern-by-pattern guide for replacing Drupal AJAX API with core HTMX in Dr
- [Configuration Forms](https://camoa.github.io/dev-guides/drupal/config-forms/): 10 guides — Configuration Forms — choose form types, build admin interfaces, implement operations
- [Custom Field](https://camoa.github.io/dev-guides/drupal/custom-field/): 19 guides — Drupal Custom Field module guides -- compound fields with multiple sub-fields stored in a single tab
- [DRY Principles in Drupal](https://camoa.github.io/dev-guides/drupal/dry-principles/): 16 guides — Drupal-specific DRY (Don't Repeat Yourself) principles - config, services, base classes, traits, plu
- [Drupal 7 to 11 Migration](https://camoa.github.io/dev-guides/drupal/migration/): 16 guides — Drupal 7 to 11 migration — decision guides for Migrate API, content strategy, and performance
- [Drupal AI Module](https://camoa.github.io/dev-guides/drupal/ai-module/): 25 guides — Drupal AI module — provider abstraction, AI operations, agents, automators, chatbot API, CKEditor, v
- [Drupal AJAX](https://camoa.github.io/dev-guides/drupal/ajax/): 26 guides — Drupal AJAX Framework — atomic decision guides for forms, commands, routes, security, performance, a
- [Drupal Blocks](https://camoa.github.io/dev-guides/drupal/blocks/): 23 guides — Drupal Blocks — block plugins, derivatives, contexts, Layout Builder, render pipeline
- [Drupal Breadcrumbs](https://camoa.github.io/dev-guides/drupal/breadcrumbs/): 14 guides — Drupal Breadcrumbs — decision guides for core builders, Easy Breadcrumb, custom builders, SEO, themi
- [Drupal Caching](https://camoa.github.io/dev-guides/drupal/caching/): 20 guides — Drupal caching decision guides — cache metadata, backends, invalidation, and performance
- [Drupal Canvas](https://camoa.github.io/dev-guides/drupal/canvas/): 17 guides — Drupal Canvas — decision guides for the React-based visual page builder using SDC and Code Component
- [Drupal Configuration Management](https://camoa.github.io/dev-guides/drupal/config-management/): 22 guides — Drupal Configuration Management — the Config API, simple config vs config entities, schema, storage,
- [Drupal Form API](https://camoa.github.io/dev-guides/drupal/forms/): 26 guides — Drupal Form API decision guides - choose the right pattern, element, and approach
- [Drupal Group Module](https://camoa.github.io/dev-guides/drupal/group/): 16 guides — Drupal Group module 3.x — group types, roles, permissions, access control, membership, GroupRelation
- [Drupal HTMX](https://camoa.github.io/dev-guides/drupal/htmx/): 18 guides — Drupal HTMX — decision guides for native HTMX integration in Drupal 11.3+
- [Drupal JSON:API](https://camoa.github.io/dev-guides/drupal/jsonapi/): 21 guides — Comprehensive guide for working with Drupal's JSON:API module (core) and JSON:API Extras (contrib). 
- [Drupal Recipes](https://camoa.github.io/dev-guides/drupal/recipes/): 22 guides — Drupal Recipes — reusable configuration patterns for composable site setup
- [Drupal Render API](https://camoa.github.io/dev-guides/drupal/render-api/): 19 guides — Drupal Render API decision guides -- render arrays, elements, caching, theming, security, and perfor
- [Drupal Routing](https://camoa.github.io/dev-guides/drupal/routing/): 12 guides — Drupal Routing - YAML route definitions, access control, dynamic routes, and security best practices
- [Drupal SEO & GEO](https://camoa.github.io/dev-guides/drupal/seo-geo/): 27 guides — Drupal SEO & GEO — search engine optimization, structured data, meta tags, and generative engine opt
- [Drupal Salesforce Suite](https://camoa.github.io/dev-guides/drupal/salesforce/): 22 guides — Drupal Salesforce Suite — bidirectional sync between Drupal entities and Salesforce objects, authent
- [Drupal Security](https://camoa.github.io/dev-guides/drupal/security/): 21 guides — Drupal security architecture, access control, XSS/CSRF/SQL injection prevention, authentication, and
- [Drupal Services & Dependency Injection](https://camoa.github.io/dev-guides/drupal/services/): 21 guides — Drupal Services & Dependency Injection decision guides — atomic references for defining services, in
- [Drupal Storybook & Stories](https://camoa.github.io/dev-guides/drupal/storybook/): 6 guides — Storybook and component story tooling for Drupal SDC themes — UI Patterns 2 story.yml (static, no No
- [Drupal Test-Driven Development](https://camoa.github.io/dev-guides/drupal/tdd/): 25 guides — Drupal Test-Driven Development guide covering PHPUnit test types, TDD workflow, testing patterns, an
- [Drupal Testing](https://camoa.github.io/dev-guides/drupal/testing/): 11 guides — Drupal Testing — automated testing frameworks for modules (PHPUnit Unit, Kernel, Functional, Functio
- [Drupal Twig Theming](https://camoa.github.io/dev-guides/drupal/twig/): 22 guides — Drupal Twig theming — template development, field access, preprocess functions, debugging, and contr
- [ECA](https://camoa.github.io/dev-guides/drupal/eca/): 21 guides — ECA (Event-Condition-Action) plugin development — create custom actions, events, and conditions
- [Entities and Fields](https://camoa.github.io/dev-guides/drupal/entities/): 20 guides — Drupal entities and fields — content types, field development, and entity patterns
- [GitHub Actions](https://camoa.github.io/dev-guides/drupal/github-actions/): 13 guides — GitHub Actions for Drupal — automated CI/CD workflows for testing, building, and deploying
- [Icon API](https://camoa.github.io/dev-guides/drupal/icon-api/): 22 guides — Icon API - unified system for managing and rendering icons across Drupal 11.1+ sites
- [Image Styles](https://camoa.github.io/dev-guides/drupal/image-styles/): 16 guides — Image styles and responsive images — configuration-first approach to derivatives, effects, breakpoin
- [JavaScript Development](https://camoa.github.io/dev-guides/drupal/js-development/): 22 guides — Drupal JavaScript Development - library-based architecture, behaviors, and modern patterns
- [Klaro Cookie & Consent Management](https://camoa.github.io/dev-guides/drupal/klaro/): 16 guides — Klaro Cookie & Consent Management — GDPR-compliant consent for Drupal sites
- [Layout Builder](https://camoa.github.io/dev-guides/drupal/layout-builder/): 25 guides — Drupal Layout Builder development guides — configuration-first approach to sections, layouts, blocks
- [Media System](https://camoa.github.io/dev-guides/drupal/media-system/): 21 guides — Drupal Media System configuration guides — media types, view modes, display configuration, Media Lib
- [Media Types](https://camoa.github.io/dev-guides/drupal/media/): 15 guides — Drupal Media Types — custom media source plugins, metadata systems, oEmbed extensions, and third-par
- [Multilingual & Translation](https://camoa.github.io/dev-guides/drupal/multilingual/): 22 guides — Drupal multilingual and translation system — language setup, content translation, config translation
- [Plugin Architecture](https://camoa.github.io/dev-guides/drupal/plugins/): 13 guides — Plugin Architecture - choose between Foundation+Extension, Provider Plugin, and Service Collector pa
- [SOLID Principles in Drupal](https://camoa.github.io/dev-guides/drupal/solid-principles/): 19 guides — SOLID principles in Drupal 11 development - services, plugins, entities, forms, hooks, dependency in
- [Single Directory Components (SDC)](https://camoa.github.io/dev-guides/drupal/sdc/): 15 guides — Single Directory Components (SDC) — component architecture, development patterns, and best practices
- [Taxonomy](https://camoa.github.io/dev-guides/drupal/taxonomy/): 16 guides — Drupal Taxonomy — vocabulary and term management, config-first development
- [UI Patterns 2.x](https://camoa.github.io/dev-guides/drupal/ui-patterns/): 18 guides — Drupal UI Patterns 2.x guides — SDC plugin architecture, props/slots/source systems, Layout Builder,
- [UI Suite DaisyUI](https://camoa.github.io/dev-guides/drupal/ui-suite-daisyui/): 16 guides — UI Suite DaisyUI guides — DaisyUI 5 theme integration with Drupal, 51 SDC components, UI Patterns/St
- [Views](https://camoa.github.io/dev-guides/drupal/views/): 33 guides — Drupal Views — query and display entity lists with UI-based configuration

## CSS

- [CSS Craft](https://camoa.github.io/dev-guides/css/css-craft/): 20 guides — CSS Craft — motion tokens, micro-interactions, depth, entrance animations, visual hierarchy, perform
- [Modern CSS](https://camoa.github.io/dev-guides/css/modern-css/): 20 guides — Modern CSS features from 2022–2025 — container queries, @scope, @layer, scroll-driven animations, vi

## JavaScript

- [Interaction Craft](https://camoa.github.io/dev-guides/js/interaction-craft/): 10 guides — Interaction Craft — vanilla JS patterns for timing, keyboard accessibility, scroll, drag-and-drop, o

## Media

- [Image & Media Craft](https://camoa.github.io/dev-guides/media/image-media-craft/): 9 guides — Image & Media Craft — front-end pipeline decisions for responsive images, format strategy, loading o

## Design Systems

- [Bootstrap Design System Mapping](https://camoa.github.io/dev-guides/design-systems/bootstrap/): 16 guides — Design system to Bootstrap 5.3 mapping guides using the 6px threshold decision framework
- [DaisyUI](https://camoa.github.io/dev-guides/design-systems/daisyui/): 14 guides — DaisyUI v5 guides — theming, color tokens, component reference, React integration, customization, ac
- [Design System Recognition](https://camoa.github.io/dev-guides/design-systems/recognition/): 12 guides — Design System Recognition — extract tokens and components from HTML/CSS, Figma, or screenshots
- [Design System to Radix SDC Mapping](https://camoa.github.io/dev-guides/design-systems/radix-sdc/): 16 guides — Design System to Radix SDC Mapping — atomic guides for implementing design systems with Drupal Radix
- [JSX to Twig](https://camoa.github.io/dev-guides/design-systems/jsx-to-twig/): 12 guides — JSX to Twig conversion patterns for React → Drupal SDC migration
- [Radix Components](https://camoa.github.io/dev-guides/design-systems/radix-components/): 14 guides — Drupal Radix Components — Complete reference for all 57 Radix 6.x Single Directory Components
- [React Design System](https://camoa.github.io/dev-guides/design-systems/react-design-system/): 17 guides — React design system guides — component architecture, props patterns, composition, Tailwind, CVA vari
- [Tailwind CSS](https://camoa.github.io/dev-guides/design-systems/tailwind/): 18 guides — Tailwind CSS design system guides — v3/v4 migration, configuration, tokens, variants, responsive, da
- [Tailwind Tokens](https://camoa.github.io/dev-guides/design-systems/tailwind-tokens/): 20 guides — Tailwind CSS 4 design tokens — decision guides for extraction, mapping, and multi-platform integrati

## Next.js

- [DeepChat + Drupal OAuth Auth](https://camoa.github.io/dev-guides/nextjs/deepchat-drupal-auth/): 7 guides — DeepChat + Drupal OAuth auth — architecture, CSRF lifecycle, configuration, pitfalls, and debugging
- [DeepChat + Next.js](https://camoa.github.io/dev-guides/nextjs/deepchat-nextjs/): 15 guides — DeepChat + Next.js integration guides covering setup, API routes, streaming, Drupal backend, and sec
- [Next.js for Drupal](https://camoa.github.io/dev-guides/nextjs/next-drupal/): 19 guides — Comprehensive guide for integrating Next.js with Drupal using the next-drupal library. Covers archit
- [TipTap Editor](https://camoa.github.io/dev-guides/nextjs/tiptap-editor/): 43 guides — TipTap Editor guides for React, Next.js, and Drupal integration

## Development Practices

- [DRY and Code Reuse Principles](https://camoa.github.io/dev-guides/development/dry-principles/): 15 guides — DRY (Don't Repeat Yourself), code reuse, and abstraction strategies - when to abstract, when to dupl
- [SOLID Principles](https://camoa.github.io/dev-guides/development/solid-principles/): 17 guides — SOLID principles for object-oriented design — decision guides for SRP, OCP, LSP, ISP, and DIP with p
- [Security Best Practices](https://camoa.github.io/dev-guides/development/security-practices/): 22 guides — Security best practices for modern web development - tool-agnostic principles covering OWASP Top 10,
- [TDD & Spec-Driven Development](https://camoa.github.io/dev-guides/development/tdd-spec-driven/): 18 guides — Decision guides for Test-Driven Development and Spec-Driven Development practices

## AI Tooling

- [Figma MCP Server](https://camoa.github.io/dev-guides/ai-tooling/figma-mcp/): 19 guides — Figma MCP Server — design-to-code AI workflows for Claude Code, VS Code, Cursor, and Windsurf

## Optional

- [Full documentation](https://camoa.github.io/dev-guides/llms-full.txt): All guides concatenated (~1.1M tokens — for RAG vectorization, not direct context)