PHPackages                             akyos/akyos-blocks - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. akyos/akyos-blocks

ActiveLibrary

akyos/akyos-blocks
==================

041PHP

Since Dec 16Pushed 5mo ago1 watchersCompare

[ Source](https://github.com/akyoscommunication/akyos-blocks)[ Packagist](https://packagist.org/packages/akyos/akyos-blocks)[ RSS](/packages/akyos-akyos-blocks/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Akyos Blocks for Sage Theme
===========================

[](#akyos-blocks-for-sage-theme)

A composer library for WordPress Sage Theme that adds the ability to import Gutenberg Blocks created with ACF into your theme.

Overview
--------

[](#overview)

This library allows you to seamlessly integrate ACF-based Gutenberg Blocks into your Sage theme. It simplifies managing block assets and enables you to override block views directly within your theme.

Features
--------

[](#features)

- **Block Import:** Easily import Gutenberg Blocks configured via a JSON file.
- **Asset Management:** Import SCSS and JS assets and automatically add dependencies to your `package.json`.
- **View Overrides:** Copy block view files into your theme for customization.
- **Service Initialization:** Automatically registers the required service through the `AkyosServiceProvider.php` in your template theme.

Installation
------------

[](#installation)

1. **Install the Composer Library:**

    Ensure you have Composer installed, then add the library to your project: `composer require akyos/blocks`
2. **Create the Configuration File:**

At the root of your Sage theme, create a file named `akyos-blocks.json`. This file should be a JSON object mapping block categories to block slugs. For example:

```
{
  "hero": "hero1",
  "map": "map1"
}

```

Setup
-----

[](#setup)

The library is initialized via the `AkyosServiceProvider.php` file, which is included in your template theme. Ensure that this service provider is correctly registered so that the library is properly bootstrapped.

Usage
-----

[](#usage)

Once installed and configured, you can manage block assets and overrides using WP Acorn commands.

### Import Block Assets

[](#import-block-assets)

`wp acorn import:block:assets`

- This command imports the necessary SCSS and JS files for your blocks by copying them into your theme and updating your `package.json` with the required dependencies.
- **Prompt:** The command will ask for the slug of the block you want to import assets for. Enter a specific block slug or `-1` to import assets for all blocks.

### Override Block View

[](#override-block-view)

`wp acorn override:block`

- This command copies the view file of a specific block into your theme, allowing you to customize the block's output.
- **Prompt:** The command will ask for the slug of the block you wish to override. Provide the slug to copy the block's view file to your theme.

Contributing
------------

[](#contributing)

Contributions are welcome! If you have suggestions or improvements, feel free to open an issue or submit a pull request.

License
-------

[](#license)

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

Happy coding!

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance50

Moderate activity, may be stable

Popularity9

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

 Bus Factor1

Top contributor holds 66.7% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/0712a2a59177f1f0b0e6be094ae8db913fcde12ed95915eb8b89992f66afade8?d=identicon)[AkyosDev](/maintainers/AkyosDev)

---

Top Contributors

[![lilianakyos](https://avatars.githubusercontent.com/u/84336616?v=4)](https://github.com/lilianakyos "lilianakyos (12 commits)")[![akyoscommunication](https://avatars.githubusercontent.com/u/50996280?v=4)](https://github.com/akyoscommunication "akyoscommunication (6 commits)")

### Embed Badge

![Health badge](/badges/akyos-akyos-blocks/health.svg)

```
[![Health](https://phpackages.com/badges/akyos-akyos-blocks/health.svg)](https://phpackages.com/packages/akyos-akyos-blocks)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)