PerAstra BlockVault – Cloud Block Library for Gutenberg

Description

Save Gutenberg blocks to a personal cloud library and insert them on any WordPress site. PerAstra BlockVault is a block manager for freelancers and agencies who reuse the same components across client sites.

Stop rebuilding the same hero sections, CTAs, pricing tables, and testimonials from scratch on every project. Save once, insert anywhere — no Multisite required.

Stop rebuilding the same sections from scratch on every client site.

Key Features

• Save any blocks — Select one or more blocks, click save, done.
• Insert anywhere — Open your library on any WordPress site and insert in one click.
• Search, filter, and sort — Find blocks by name or category; filter by Favorites or by Collection; sort newest, oldest, or A–Z / Z–A.
• Favorites (pinning) — Pin your most-used blocks to the top. (Solo plan or higher.)
• Collections — Group related blocks into named collections for projects or client sites. (Solo plan or higher.)
• Inline edit — Rename blocks, change categories, add notes, and assign collections without leaving the sidebar.
• Bulk actions — Multi-select blocks for bulk delete (with confirmation) or duplicate.
• Keyboard shortcut — Save selected blocks without reaching for the mouse.
• Content preview — See a text preview of saved blocks before inserting.
• CSS capture (opt-in) — Optionally extract theme CSS so blocks look identical on other sites. (Pro plan or higher.)
• Notes — Add private notes to any block for future reference. (Solo plan or higher.)
• In-plugin sign-up / login — Create a free account or log in right from the settings page — no copy-pasting keys required.
• Automatic local-to-cloud migration — Any blocks you saved in local mode transfer to your account automatically the first time you connect.
• Usage meter — See your current block usage against your plan limit at a glance.
• Works across sites — Connect your account to sync blocks across completely separate WordPress installs.
• No multisite required — Works on any standard WordPress installation.
• Block context menu — Right-click any block and choose « Save to BlockVault ».
• Local mode — Works offline with browser storage when no account is connected.

How it Works

1. Design a block or section on any WordPress site
2. Select the blocks in the editor
3. Click « Save to BlockVault » — name it, categorize it
4. On another site, open the BlockVault sidebar
5. Search or browse your library, click Insert

Use Cases

• Freelancers — Build a library of hero sections, CTAs, pricing tables, and testimonials. Reuse across client projects.
• Agencies — Share branded components across your team and client sites.
• Content creators — Save frequently used layouts and insert them instantly.

External Services

When an API key is configured, this plugin connects to the BlockVault cloud API (operated by PerAstra) to sync your block library across sites. The following data is transmitted:

• Your API key (for authentication)
• Your site URL (for per-site tracking)
• Block names, categories, and markup content (when saving or retrieving blocks)

No data is sent when using local mode (no API key configured).

• BlockVault cloud API endpoint: https://api.block-vault.com
• Privacy Policy: https://block-vault.com/privacy
• Terms of Service: https://block-vault.com/terms

Source Code & Development

The full unminified source and the build tooling required to regenerate the compiled files are both included inside the plugin zip AND hosted publicly on GitHub.

• Source repository: https://github.com/Samuel-Gassama/perastra-blockvault

Source vs compiled files

The plugin zip contains both the original source and the compiled output:

• src/ — original unminified JavaScript (React / JSX) and SCSS source. Everything the UI does is here.
  • src/index.js — editor plugin entry point (registers the sidebar and context-menu integration)
  • src/components/ — sidebar, block list, block item, save modal
  • src/store/ — @wordpress/data Redux store
  • src/api/ — cloud API client, localStorage fallback, and the router between them
  • src/hooks/, src/utils/ — helpers for selected-block access, color/CSS resolution
  • src/style.scss — sidebar styles
• build/ — compiled output loaded by WordPress. Not edited by hand. Includes:
  • build/index.js (minified bundle of everything under src/)
  • build/style-index.css and build/style-index-rtl.css (compiled from src/style.scss)
  • build/index.asset.php (auto-generated dependency manifest)

Build requirements

• Node.js 18 or later
• npm (comes with Node)

The only build tool is @wordpress/scripts, the official WordPress build wrapper around webpack + Babel. No custom webpack or Babel config is used — the defaults from @wordpress/scripts are used verbatim.

Rebuilding the compiled files

From the plugin directory, run:

npm install
npm run build

That produces the contents of build/ from src/. Other available commands (defined in package.json):

• npm run start — watch mode during development
• npm run lint:js — lint JavaScript
• npm run lint:css — lint SCSS

No PHP compilation is required — all PHP files (perastra-blockvault.php, uninstall.php, includes/*.php) are the original human-readable source.