On this page
Getting Started

Getting started with Acrosite

Set up Acrosite end to end: create a workspace, add a project, connect GitHub, choose a deployment trigger, and publish your first content item.

TutorialFor New workspace ownersUpdated November 12, 2026

Acrosite is a Git-backed content platform. Your team writes in a clean dashboard, and Acrosite commits the content to your website's GitHub repository as Markdown, then triggers your site to redeploy. This guide takes you from sign up to your first published content item.

Who this is for

This is for the person setting up Acrosite for the first time — usually the workspace owner. You do not need to be a developer, but connecting GitHub does require someone who can install a GitHub App on the repository.

Before you start

You will move faster if you have these ready:

  • An Acrosite account (sign up at the Start Free Trial link).
  • A GitHub repository that already builds and deploys your website.
  • Permission to install a GitHub App on that repository's account or organization.
  • The branch Acrosite should write to, such as main.
Note
If your repository is not ready yet, you can still create your workspace, project, and content. You only need GitHub before you publish.

The setup path

Most teams finish setup in a single session. Work through these steps in order — each one has its own detailed guide linked below.

  1. Create your workspace and choose a Workspace Username.
  2. Add your first project. One project represents one website.
  3. Connect GitHub: install the Acrosite GitHub App, then choose the repository and branch.
  4. Choose how your site deploys after each publish: Git-connected (your host builds from the commit), a deploy hook, or Manual.
  5. Create a Post or Page and write the body in the editor.
  6. Optionally, submit it for review and have it approved. Review is not required to publish.
  7. Schedule it for later, or choose Publish Now.
  8. Open Publish Logs to confirm the commit and deployment trigger.

What happens next

When content publishes, Acrosite commits a Markdown file to your repository on the branch you selected, commits any images the content uses, and, if the project uses a deploy hook, sends your deployment trigger so your hosting provider rebuilds the site. With Git-connected, your host builds from the commit on its own. Every attempt is recorded in Publish Logs, and each deployment trigger is recorded in Deployment Logs.

Important
Acrosite triggers your deployment; that does not mean the build finished. Owners and Admins see the build status your host reports to GitHub (see Build status); otherwise, use your hosting provider's dashboard to confirm the live site has updated.

Next steps

Start with the detailed guides for each step:

If you would rather understand the product first, read What is Acrosite? and the Core concepts.