bluefly/recipe_onboarding

AI-powered platform onboarding with recipe discovery, guided setup workflows, and comprehensive testing framework

v0.1.2 2025-07-14 10:46 UTC

Requires

• php: >=8.1
• drupal/ai: ^1.0@beta
• drupal/ai_provider_ollama: ^1.0@beta
• drupal/ai_provider_openai: ^1.1@beta
• drupal/core: ^10.3 || ^11
• drupal/eca: ^2.0
• drupal/field_permissions: ^1.4
• drupal/key: ^1.0
• drupal/queue_ui: ^3.2
• drupal/security_review: ^3.1
• drupal/token: ^1.0
• drupal/workbench_access: ^2.0

Suggests

• bluefly/llm: LLM Platform integration for advanced AI features
• drupal/ai_automators: AI automation tools for enhanced onboarding
• drupal/ai_provider_anthropic: Anthropic provider for advanced AI features
• drupal/ai_provider_ollama: Ollama provider for local AI processing
• drupal/ai_provider_openai: OpenAI provider for AI-powered recipe recommendations

GPL-2.0-or-later

• Recipe Onboarding Contributors
• Bluefly Collective

• drupal
• ai
• recipe
• onboarding
• developer-tools
• guided-setup

README

A Drupal module that provides enhanced recipe management following native Drupal patterns.

Features

Native Recipe Management

• Recipe Discovery: Finds recipes in standard locations
• Recipe Application: Uses core drush recipe command
• Progress Tracking: Tracks which recipes have been applied
• Simple UI: Admin forms for recipe management

Enhanced Features (Built on Native Patterns)

• Onboarding Sessions: Guide users through recipe application
• AI Recommendations: Suggest relevant recipes based on site needs
• Analytics: Track recipe usage and success rates
• Developer Tools: Help create new recipes

Usage

Admin UI

1. Navigate to Configuration > Development > Recipes
2. View available recipes
3. Click "Apply Recipe" to apply a recipe
4. Use dry run option to preview changes

Drush Commands

# List available recipes
drush recipe:list

# Get info about a specific recipe
drush recipe:info llm_platform

# Apply a recipe (core command)
drush recipe /path/to/recipe

Architecture

The module follows native Drupal patterns:

• Entities: Uses content entities for tracking (OnboardingSession, Recipe metadata)
• Services: Simple services that wrap core functionality
• Forms: Standard Drupal forms for UI
• Commands: Drush commands that complement core drush recipe

No Over-Engineering

This module does NOT:

• Auto-analyze module dependencies
• Generate configuration suggestions
• Create complex automation workflows

Instead, it:

• Helps discover available recipes
• Provides a UI for the core recipe system
• Tracks what has been applied
• Offers optional enhancements like AI recommendations

Recipe Structure

Drupal recipes follow a simple structure:

name: 'My Recipe'
description: 'What this recipe does'
type: 'Site'
install:
  - module_name
  - another_module
config:
  actions:
    system.site:
      simple_config_update:
        name: 'My Site'

That's it! The recipe system handles module installation and configuration updates.