sitegeist/fluid-styleguide

Living styleguide for Fluid Components

2.1.3 2024-10-11 12:13 UTC

Requires

• php: ^8.2
• colinodell/json5: ^2.1
• erusev/parsedown: ^1.7.4
• sitegeist/fluid-components: ^3.0 || dev-master
• typo3/cms-core: ^13.3 || ^12.4

Requires (Dev)

• editorconfig-checker/editorconfig-checker: ^10.0
• squizlabs/php_codesniffer: ^3.0
• typo3/testing-framework: ^8.2

Suggests

• sitegeist/fluid-components-linter: Checks fluid components for code quality problems via CLI and in the styleguide

GPL-2.0-or-later

• Ulrich Mathes
• Simon Praetorius

• template
• components
• html
• typo3
• styleguide
• fluid
• typo3-extension
• typo3-fluid
• living-styleguide

README

Fluid Styleguide is a design collaboration tool for TYPO3 projects. It supports frontend developers in creating reusable components and encourages effective communication across all project stakeholders.

Try the live demo

Target Groups

Fluid Styleguide can be a useful tool for all project stakeholders:

• designers and frontend developers can improve their development and QA workflows
• frontend, backend and integration discuss and coordinate data structures and interfaces between the stacks
• project managers and product owners see the current state of the project's components
• clients get more transparency of the project status

Features

• visualization of project components
• isolated development of components
• responsive testing
• integrated component documentation
• support for multiple languages
• support for frontend assets provided by TYPO3's asset collector
• shows code quality problems based on fluid-components-linter
• basic skinning to fit the project's brand colors
• zip download
• easy and flexible configuration via yaml file
• live editing of example data [BETA]

Getting Started

Just follow these simple steps to get started with the styleguide:

1. Install Fluid Styleguide

   via composer:

    composer require sitegeist/fluid-styleguide
   

   or download the extension from TER:

   TER: fluid_styleguide

2. Test Fluid Styleguide with demo components

   Just open the page /fluid-styleguide/ in your TYPO3 installation:

    https://my-domain.tld/fluid-styleguide/
   

To add your own components to the styleguide, just follow these additional steps:

1. Configure Fluid Components

   Make sure to define the component namespace in your ext_localconf.php:

   $GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['fluid_components']['namespaces']['VENDOR\\MyExtension\\Components'] =
       \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::extPath('my_extension', 'Resources/Private/Components');

   Use your own vendor name for VENDOR, extension name for MyExtension, and extension key for my_extension.

2. Configure your frontend assets

   Create a styleguide configuration file in your extension or sitepackage.

   Configuration/Yaml/FluidStyleguide.yaml:

   FluidStyleguide:
       ComponentAssets:
           Packages:
               'Vendor\MyExtension\Components':
                   Css:
                       - 'EXT:my_extension/Resources/Public/Css/Main.min.css'
                   Javascript:
                       - 'EXT:my_extension/Resources/Public/Javascript/Main.min.js'

   Use your own vendor name for VENDOR, extension name for MyExtension, and extension key for my_extension. Adjust the paths to the assets according to your directory structure.

3. Start building your own components using Fluid Components and fixture files

If you have any questions, need support or want to discuss components in TYPO3, feel free to join #ext-fluid_components.

Documentation

• Building Components with Fluid Styleguide
• Styleguide Configuration Reference