https://github.com/pixelgrade/nova-blocks
A collection of design-driven WordPress editor blocks committed to making your site shine like a newborn star 💫
https://github.com/pixelgrade/nova-blocks
block-editor color-system design-system font-styles gutenberg gutenberg-blocks wordpress wordpress-plugin
Last synced: about 2 months ago
JSON representation
A collection of design-driven WordPress editor blocks committed to making your site shine like a newborn star 💫
- Host: GitHub
- URL: https://github.com/pixelgrade/nova-blocks
- Owner: pixelgrade
- License: gpl-3.0
- Created: 2019-05-10T14:59:47.000Z (about 7 years ago)
- Default Branch: main
- Last Pushed: 2026-04-08T13:24:50.000Z (2 months ago)
- Last Synced: 2026-04-08T14:37:04.845Z (2 months ago)
- Topics: block-editor, color-system, design-system, font-styles, gutenberg, gutenberg-blocks, wordpress, wordpress-plugin
- Language: JavaScript
- Homepage: https://pixelgrade.com/plugins/nova-blocks/
- Size: 53.1 MB
- Stars: 66
- Watchers: 5
- Forks: 5
- Open Issues: 41
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Nova Blocks for Gutenberg Space
### Nova Blocks is a collection of distinctive Gutenberg blocks, committed to making your site shine like a newborn star. It is taking a design-driven approach to help you made the right decisions and showcase your content in the best shape.
[Download for Free](https://downloads.wordpress.org/plugins/nova-blocks.latest-stable.zip)
[](https://github.com/pixelgrade/nova-blocks/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aclosed+) [](https://github.com/pixelgrade/nova-blocks/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aopen)
[](https://pixelgrade.com/plugins/nova-blocks/)
### Positioning
*Clear and obvious, exciting and not afraid to take risks, distinctive, forward thinking.*
1. Obvious not *confusing*
2. Exciting not *dull*
3. Distinctive not *common*
### Principles
1. Decisions not options.
2. Purpose-driven
3. Distinctive
4. Cross-themes oriented
## FAQs:
**Can I use the Nova blocks with my own theme?**
Yes! Nova Blocks are built to inherit your theme style as much as possible.
**Is Nova Blocks free?**
Yes! Nova Blocks' core features are free to use.
## Installation
1. Log in to your WordPress dashboard and navigate to the Plugins menu, and click “Add New.”
2. In the search field type “Nova Blocks,” then click “Search Plugins.”
3. Once you’ve found the plugin, click “Install Now,” and then click “Activate”.
4. Do the same steps for the “Gutenberg” plugin and install the latest version of the Editor.
5. Start using the new blocks on your pages by searching and/or selecting them from the **Nova Blocks** section of the Gutenberg Editor.
## Completely compatible with the following WordPress themes:
- [Mies LT](https://pixelgrade.com/themes/portfolio/mies-lt/) _by Pixelgrade_
- [Julia LT](https://pixelgrade.com/themes/blogging/julia-lt/) _by Pixelgrade_
- [Rosa LT](https://pixelgrade.com/themes/restaurants/rosa-lt/) _by Pixelgrade_
- [Felt LT](https://pixelgrade.com/themes/blogging/felt-lt/) _by Pixelgrade_
## Contributing
The essence of **open source** is that by freely sharing the code, you have the freedom to use it for any purpose, study how it works and adapt it to your needs, improve the program and **share your improvements** with the community so that we all benefit. 🙏
It's great if you're willing to use your skills, knowledge, and experience to help further refine this project with your own improvements. We really appreciate it and you're 💯 welcome to submit an issue or pull request on any topic.
### How can you help?
- 🐛 **Discovered an issue?** Please report it [here](https://github.com/pixelgrade/nova-blocks/issues/new?assignees=&labels=%5BType%5D+Bug&template=bug_report.md&title= "here") and help us fix it.
- 🛠 **Fixed a bug?** That’s fantastic! Send a [pull request](https://github.com/pixelgrade/nova-blocks/pulls "pull request") and we will look over it.
- 🙋 **Need a feature?** Please take a moment to find out whether your idea fit the wider scope of this theme and provide as much detail and context as possible. Then propose it [here](https://github.com/pixelgrade/nova-blocks/issues/new?assignees=&labels=%5BType%5D+Feature&template=feature_request.md&title=).
- 💎 **Have you made something great?** [Share](https://github.com/pixelgrade/nova-blocks/issues/new "Share") it with us.
### Contributors
A manually curated list that include all the valuable people that have contributed to this project with code, user testing, feedback, or mockups. Thank you!
[](https://github.com/razwan) [](https://github.com/georgeolaru) [](https://github.com/oanafilip) [](https://github.com/vladolaru) [](https://github.com/madalingorbanescu) [](https://github.com/acosmin) [](https://github.com/loxK)
## Local Environment Setup Pointers
You need to be careful since we **require** certain **Node.js (v14) and PHP (v7.4) versions.**
For ease of development, it is best to use [**nvm**](https://github.com/nvm-sh/nvm) for node version management and automatic node version switching on shell navigation. For the `zsh` shell the easiest way is to use [oh-my-zsh](https://github.com/ohmyzsh/ohmyzsh) with the `nvm` [plugin](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/nvm) activated.
We use the following oh-my-zsh plugins: `plugins=(composer git nvm npm)` configured in `~/.zshrc`. For automatic node version switching, place this line in `~/.zshrc` just below the plugins line: `NVM_AUTOLOAD=1`. Now whenever you enter a directory through the shell, if it finds a `.nvmrc` file, it will switch to the specified node version.
## Private Local Overlays
This repo supports a split between tracked public templates and ignored local private files.
Tracked files:
- `AGENTS.md`
- `AGENTS.local.example.md`
- `.claude/napkin.example.md`
- `.env.example`
- `bin/bootstrap-private`
Ignored files:
- `AGENTS.local.md`
- `.ai/`
- `.claude/napkin.md`
- `.env.local`
- `.private/`
Recommended workflow:
1. Put your real private files in a separate private repo, for example `nova-blocks-private`.
2. Store any of these files there when needed:
- `AGENTS.local.md`
- `.ai/`
- `.claude/napkin.md`
- `.env.local`
3. After cloning `nova-blocks`, configure the private repo once:
```bash
git config --local novablocks.privateRepo git@github.com:/nova-blocks-private.git
```
4. Hydrate the local private files:
```bash
bin/bootstrap-private
```
Useful variants:
```bash
# replace existing local private files from the private source
bin/bootstrap-private --force
# symlink the files instead of copying them
bin/bootstrap-private --link
# use an existing local checkout of your private repo
bin/bootstrap-private --source-dir /path/to/nova-blocks-private
```
Use `AGENTS.local.md` for shared private instructions, `.ai/` for vendor-neutral plans/research notes, and `.claude/napkin.md` for tool-specific distilled working memory.
The bootstrap script syncs `AGENTS.local.md`, `.ai/`, `.claude/napkin.md`, and `.env.local` when those files exist in the private source.
## License
Nova Blocks source code is released under the [GNU GPL v3 license](https://www.gnu.org/licenses/gpl-3.0.en.html) or later. This is so you have the freedom to create something beautiful and share it back with us.
2019-2022 © Pixelgrade.