typo3-sitepackage

TYPO3 Site Package Development Skill

This skill guides you through creating a TYPO3 site package - a special extension that contains all site-specific templates, configuration, and assets.

Prerequisites

Before starting, gather the following information from the user:

1. Extension key - lowercase with underscores (e.g., my_site)
2. PHP vendor namespace - PascalCase (e.g., MyCompany)
3. Author information - name, email, company (retrieve from git config if not provided)
4. Base package type - which template base to use:
   • site_package_tutorial - Minimal setup for learning
   • bootstrap_package - Based on Bootstrap framework
   • fluid_styled_content - Based on TYPO3's default content rendering
5. Required extensions - any additional TYPO3 extensions to include as dependencies (e.g., news, form)

Workflow

Step 1: Create Site Package

Use typo3_create_sitepackage to create the site package structure.

DO NOT make any assumptions about the authorship information. Either ask the user for it or retrieve it from git config. Always ensure the extension key and PHP vendor namespace are provided by the user. You are allowed to make suggestions.

Tool: typo3_create_sitepackage
Parameters:
- extensionKey: (from user, e.g., "my_site")
- phpVendorNamespace: (from user, e.g., "MyCompany")
- title: (e.g., "My Company Website")
- description: (1-2 sentences about the site)
- author: (from user or git config)
- authorEmail: (from user or git config)
- authorCompany: (company name)
- type: (one of: site_package_tutorial, bootstrap_package, fluid_styled_content)
- homepage: (optional, company website URL)

Step 2: Configure Composer

If the user provided additional required extensions, add them as dependencies in the composer.json of the site package.

Step 3: Create Site Set

Site sets are TYPO3's modern way to configure sites. Create one for your site package.

Use typo3_create_site_set:

Tool: typo3_create_site_set
Parameters:
- extensionKey: (from step 1)
- identifier: (composer package name, e.g., "mycompany/my-site")
- path: (directory name, e.g., "my-site")
- label: (human readable, e.g., "My Company Site")
- dependencies: (optional array, e.g., ["typo3/fluid-styled-content"])