Previewing Changes Before Pushing to Production

With the Git Integration, analysts may want to develop a workflow where they can preview all of their changes in the Periscope application before publishing for all of their end users to see. Below is the suggested workflow for this use case. 

Note: This solution requires the Git integration, 2 spaces and recommends the Slack Integration. The Git integration, Spaces and the Slack integration are add-on features. Site administrators can reach out to their Account Manager for more information. 


There will be 1 space dedicated to development and 1 space dedicated to production. The development space should only be visible to analysts and editors. The production space will be used for external use and end users.

Each space will be connected to their own separate Git repositories. One repository cannot be connected to two different spaces in Periscope.

All changes in the development space will be migrated to the production space with this solution. Be sure that the entire development space looks exactly how the production space should look before migrating. After the migration, both spaces will be identical to each other. 

The Slack Integration is recommended in order to be notified of any errors during the process. Errors can also be found as Git Tags in the repositories. If any errors occur during the process, resolve the errors before continuing. Check the bottom of the Git Integration page for more details on troubleshooting Git.


Make edits and preview changes in the development space. Be sure to be on the periscope/master branch.

  1. Run git pull in the development repository. 
  2. Make desired changes in the development repository and git push to origin in order to preview any changes in-app. 
  3. Be sure to run git pull after any pushes, and if there are changes made in-app that need to be synced to the repository. 

Once the development space and repository are in the desired state, it is ready to be copied over to the production space. 

  1. Run git pull in the production repository.
  2. Delete all dashboard directories in the production repository. Do NOT commit or push after deleting. 
  3. Copy all dashboard directories from the development repository to the production repository. 
  4. Commit and run git push to origin once the production repository looks identical to the development repository. 
  5. Run a git pull.
  6. Observe changes in the production space.

<a href="#top">Back to top</a>

Our support team is ready to help