Wagtail SB Blocks

Package with basic, adaptable and reusable blocks to build awesome sites with wagtail.

Package to render Wagtail StructBlock with basic, adaptable and reusable blocks to build awesome sites with wagtail.

✨ Features

• Standard Blocks: Out-of-the-box blocks like Headers, Paragraphs, Figures, Buttons, Embeds, and Lists.
• Enhanced StreamBlock: Removes unnecessary wrapper divs.
• Modern Stack: Built for modern Python (3.11+) and up to date Django/Wagtail versions.

📋 Requirements

• Python 3.11 or higher
• Wagtail 5.2 or higher
• Django 4.2 or higher

📦 Installation

Using pip

pip install wagtail-sb-blocks

Using uv

uv add wagtail-sb-blocks

🚀 Usage

Add wagtail_sb_blocks to your INSTALLED_APPS settings:

INSTALLED_APPS = [
    # ...
    "wagtail_sb_blocks",
    # ...
]

In your stream blocks use blocks from this package to rapid development.

from wagtail.blocks import StreamBlock

from wagtail_sb_blocks.blocks.legacy import H1, Paragraph, Figure, Button


class EnhancedHTMLBlock(StreamBlock):
    title = H1()
    paragraph = Paragraph()
    figure = Figure()
    button = Button()

🛠️ Development

Check out our Contribution Guide for details on setting up your development environment, running tests, and submitting pull requests.

The project uses uv for dependency management, ruff for linting, and tox for multi-environment testing.

📜 Changelog

See the CHANGELOG.md for a history of changes.

👥 Contributors

See our list of contributors.

📄 License

This project is licensed under the Apache License 2.0. See the LICENSE file for details.