Skip to content

kleinweb/gutenberg-rust-starter

 
 

Repository files navigation

Gutenberg + Rust + TypeScript

This is a minimum block plugin template to rapidly get started building WP blocks using Rust + TypeScript.

Getting Started

  • Run npm install to install necessary packages
  • Run npm run rename <text-domain> <label> to rename from rust-starter.
  • Run npm run start to start the dev server
  • Run cypress open to run interactive tests

Features

This is an opinionated starter template that is designed to fit my personal workflow. However, I've added a small script to clean up and remove some features.

  • To remove Tailwind, run npm run eject tailwind
  • To remove Rust, run npm run eject rust
  • To remove Cypress, run npm run eject cypress

Rust

Rust is a systems programming language with a strong type system, memory safety, and great documentation. Beyond that it's fun to write and has a great community of helpful developers. Rust also compiles into WebAssembly, letting us utilize the power of systems programming on the web.

Read more about Rust: https://www.rust-lang.org/

TypeScript

TypeScript is essentially JavaScript with type safety. TypeScript will save you plenty of headaches while writing your code. Ever try to access a JS property on undefined? TypeScript will warn you before you even press save.

Read more about TypeScript: https://www.typescriptlang.org/

Tailwind CSS (heavily scoped)

Tailwind CSS is a utility framework designed for rapid building. Rather than maintaining CSS/scss files, you use specific class names directly in your markup, keeping the component logic, layout, and design in one place. You should default to WordPress components and classes when possible, and use Tailwind for everything beyond that.

This starter repo builds on top of Tailwind in a few useful ways:

  • Separates editor and frontend styles and processes them in isolation, keeping the stylesheet size on the frontend to a minimum
  • Removes the preflight and global Tailwind styles/animation presets so that there isn't a conflict with other blocks, plugins, etc.
  • On frontend styles, padding and margins will only be applied if the block doesn't have inline styling (e.g. .p-4:not([style*="padding"])). This lets you define a default while letting users override these values. Open an issue for more info.

Read more about Tailwind CSS: https://tailwindcss.com/

Cypress e2e testing

Cypress is a CLI test runner as well as an interactive one. Essentially it will run your tests through a browser, clicking here or there as you tell it to. It has an intuative API and is easy to learn. I've included some helpers to get started with WordPress, such as cy.loginUser() and cy.visitNewPageEditor()

Read more about Cypress: https://www.cypress.io/

Projects using this starter template

About

Gutenberg + Rust + TypeScript

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 72.7%
  • TypeScript 14.0%
  • Rust 6.5%
  • CSS 4.3%
  • PHP 2.5%