---
title: Remix Framework Guide
description: In this guide, you will learn how create and deploy a Remix application on the WP Engine Headless Platform.
url: https://developers.wpengine.com/docs/headless-platform/framework-guides/remix/
image: https://developers.wpengine.com/og/docs/headless-platform/framework-guides/remix.png
---

# Remix Framework Guide

## Introduction

Remix is a React-based framework that provides both server and client runtimes and utilizes web standard approaches and browser APIs to facilitate framework interactions. Remix embraces the client/server model and supports a zero-JS experience.

## Deploy Steps

To get started, you can run the following command to create a new Remix project:

`npx create-remix@latest`

When prompted, select `Remix App Server` in the console.

Or, if you want to start with a template designed specifically for headless WordPress, you can clone this starter template:

`git clone https://github.com/JEverhart383/remixing-wordpress`

After you have created your application, cd into your project directory:

`cd <your project directory>`

### Push Initial Commits to Your Repository

To deploy your project to our Headless Platform, it will need to be available on a remote GitHub, Bitbucket or GitLab repository.

Create a new remote repository, and then run the following commands to initialize and configure your local and remote repositories:

Terminal window

```shell
# Add remote repository
$ git remote add origin https://<your-git-provider>.com/<username>/<repo>


# Stage all changed files
$ git add -A


# Commit the files to the current branch
$ git commit -m "initial commit"


# Push changes to remote repository
$ git push -u origin main
```

### Build Details

Using the `Remix App Server` selection, there are no additional changes needed to build or deploy a Remix app on our Headless Platform.

### Deploy Your Repository

Once your project is in your remote repository, you can follow the [directions in our getting started guide](https://developers.wpengine.com/docs/headless-platform/getting-started/deploy-from-existing-repo/) to deploy your project to our Headless Platform.

## Was this helpful?

Thanks for the feedback!

```json
{"@context":"https://schema.org","@graph":[{"@type":"WebSite","@id":"https://developers.wpengine.com/#website","name":"WP Engine Product Documentation","url":"https://developers.wpengine.com/","description":"Resources for developing, deploying, and scaling on WP Engine.","inLanguage":"en-US","keywords":["API documentation","product documentation","headless WordPress","managed WordPress hosting"],"publisher":{"@id":"https://wpengine.com/#organization"}}]}
```