harmonyui/ui-bundle

HarmonyUI Bundle - UI components for Symfony

dev-main 2025-10-22 21:17 UTC

Requires

• php: >=8.2
• gehrisandro/tailwind-merge-php: ^1.0
• symfony/config: ^6.4|^7.0
• symfony/dependency-injection: ^6.4|^7.0
• symfony/framework-bundle: ^7.0
• symfony/ux-twig-component: ^2.0
• symfony/yaml: ^6.4|^7.0
• twig/extra-bundle: ^3.8
• twig/html-extra: ^3.8
• twig/twig: ^3.0

MIT

• Nicolas Lopes

• symfony
• ui
• bundle

README

Note: This is a read-only subtree split. No issues or pull requests will be accepted here. Please submit all contributions, bug reports, and feature requests at https://github.com/nicolaslps/HarmonyUI

Warning

NOT PRODUCTION READY - This project is currently in active development and is NOT ready for production use. APIs are unstable, breaking changes will occur, and features may be incomplete. Use at your own risk. Do not use in production environments.

Symfony bundle providing UI components with seamless JavaScript integration and modern styling.

Installation

composer require harmonyui/ui-bundle

Setup

1. Add JavaScript package

Add to your package.json:

"@harmonyui/primitives": "file:vendor/harmonyui/ui-bundle/assets"

2. Install dependencies

npm install
pnpm install
yarn install
...

3. Import JavaScript

import '@harmonyui/primitives';

4. Configure CSS

@source "path_to_your_project_root/vendor/harmonyui/ui-bundle/src/Resources/config/styles/**/*";
@custom-variant dark (&:is(.dark *));
@theme inline {
    --color-background: var(--background);
    --color-foreground: var(--foreground);
    /* ... theme variables ... */
}

5. Configure Form Theme (Optional)

To use HarmonyUI components for rendering Symfony forms, add the form theme to your twig.yaml:

# config/packages/twig.yaml
twig:
    form_themes:
        - '@ui/form/harmonyui_layout.html.twig'

This will automatically render all your Symfony forms using HarmonyUI components like Input, Textarea, Select, Button, Field, Label, etc.

Requirements

• PHP 8.2+
• Symfony 7.0+
• Twig 3.0+

Development Status

⚠️ Development Version - APIs and functionality may change.

License

MIT