XPEDITE for Umbraco

Create Umbraco headless websites FAST! XPEDITE guides you through setting up headless Umbraco websites and automates building unit tested components.

Why use XPEDITE?

When you install XPEDITE you don't get a prebuilt website, you get a framework that allows you to build the components you need as quickly and robustly as possible. Here are some useful features that come installed as standard.

Easy install

All you need to do to install XPEDITE is add the NuGet package to your project. The section is automatically added to the admin user and if you use the XPEDITE.StarterKit package you will have some basic items installed automatically.

Guided setup

No need for a readme, XPEDITE gives you all the instructions you need on the dashboard. When you complete a step it automatically gets crossed off. Some parts of the process are even automated and can be completed with a single button click.

A light framework

A small amount of files are added to your Next.js project that give you the minimum functionality required to connect to Umbraco and render headless pages using a familiar templates, partials, and blocks convention similar to server side Umbraco sites.

Automatic code generation

XPEDITE generates unstyled react components based on settings configured by the developer in simple to use GUI in the Umbraco backoffice. This can be downloaded or directly applied to your codebase with a single button click.

AUTOMATIC Unit test generation

Based on React testing library and Jest, XPEDITE automatically generates the mock data and unit test files needed to unit test your components. The snapshot test is automatically configured, all you need to do is fill in your own assertions based on how you want your components to work.

Helpful assistants

Inbuilt assistants will check for missing configuration or best practices suggestions and allow these to be resolved with a click of a button. Examples include setting up blocks in all relevant data types and adding documentation pages.

XPEDITE is very easy to set up. Below is a video showing how you can install, configure, and automatically generate code.

Install the XPEDITE StarterKit

dotnet add package XPEDITE.StarterKit

INSTALL UMBRACO WITH XPEDITE

# Install Umbraco templates
dotnet new install Umbraco.Templates::15.2.3 --force

dotnet new umbraco --force -n "CMS"  --friendly-name "Administrator" --email "admin@admin.com" --password "1234567890" --development-database-type SQLite

#Add Package
dotnet add "CMS" package XPEDITE.StarterKit

#Run
dotnet run --project "CMS"

or in one command

dotnet new install Umbraco.Templates::15.2.3 --force && dotnet new umbraco --force -n "CMS"  --friendly-name "Administrator" --email "admin@admin.com" --password "1234567890" --development-database-type SQLite && dotnet add "CMS" package XPEDITE.StarterKit && dotnet run --project "CMS"

Documentation

Autogenerate components with XPEDITE

Why start from scratch when XPEDITE can create your Next.js components for you. You choose your Umbraco content types and XPEDITE outputs headless React components that consume the data from the Umbraco Delivery API.

Autogenerate tests with XPEDITE

Creating mock data for unit testing is very tedious, so XPEDITE allows you to create test files with data that comes directly from items you've created in the CMS.