Skip to main content
U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.

Https

The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.

Getting started with Netlify CMS

Federalist recently integrated support for Netlify CMS, an open source content management system for your Github-based content that provides editors with a friendly UI and workflow.

Building a new site from template

The Federalist templates include pre-configured Netlify CMS functionality. To begin utilizing:

  1. select the template that you wish to use as your base site
  2. navigate to the new repository that Federalist created, and update the Netlify CMS configuration to point to the current repository
    # Jekyll: /admin/config.yml
    # Gatsby or Hugo: /static/admin/config.yml

    backend:
      ...
      repo: <your org>/<your repo>
      ...
  1. when you are done, your configuration should look something like the one in configuration requirements

  2. once your site is rebuilt in Federalist, Netlify CMS is ready to use! Navigate to https://<your site url>/admin and edit away.

Adding Netlify CMS to existing site

If your site is already up and running, please follow the instructions on Netlify’s Add To Your Site page to add Netlify CMS. Please pay particular attention to the location of the admin folder depending on your static site generator.

For examples of existing configurations, see the Federalist starter:

Configuration Requirements

To use Netlify CMS, you must authenticate with Github, and in order for Federalist to facilitate this, your Netlify CMS configuration should include the following:

  
    backend:
      name: github
      repo: <your org>/<your repo>
      base_url: https://federalistapp.18f.gov
      auth_endpoint: external/auth/github
      preview_context: federalist/build
      branch: main
      

      # optional
      use_graphql: true
    ...

See Netlify CMS Backends Overview for a full description of the configuration options.

Authentication Requirements

Because Federalist facilitates the authentication with Github, we require users of Netlify CMS to be Federalist users in addition to having write permissions to the Github repository.

Getting familiar with Netlify CMS

To learn more about Netlify CMS and how it may help you manage content changes on your Federalist site, please visit netlifycms.org/