惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

爱范儿
爱范儿
WordPress大学
WordPress大学
博客园 - 【当耐特】
The Cloudflare Blog
B
Blog
Last Week in AI
Last Week in AI
小众软件
小众软件
量子位
S
SegmentFault 最新的问题
V
Visual Studio Blog
博客园 - 叶小钗
美团技术团队
阮一峰的网络日志
阮一峰的网络日志
Hugging Face - Blog
Hugging Face - Blog
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
宝玉的分享
宝玉的分享
A
About on SuperTechFans
雷峰网
雷峰网
J
Java Code Geeks
Microsoft Azure Blog
Microsoft Azure Blog
腾讯CDC
MongoDB | Blog
MongoDB | Blog
酷 壳 – CoolShell
酷 壳 – CoolShell
Martin Fowler
Martin Fowler

CloudCannon Blog

Building with AI: Git-based vs headless vs traditional CMS CloudCannon + Astro: performance meets powerful content management Introducing the Astro Component Starter Introducing Jetstream — built on the Astro Component Starter Why we switched to the system font stack Redesigning CloudCannon’s docs with Diátaxis, Lume, and Pagefind Make content editing more visual: upgraded Editable Regions How Configuration Mode makes building editing interfaces easy Your hosting just got an upgrade (and a price cut) Custom testing domains for professional branding Keep your content consistent with input validation Managing multilingual content in CloudCannon Simplify team publishing with conflict resolution and domain tools Open Beta: Publishing Conflict Resolution Getting started with CloudCannon and Astro: Bookshop, components, and live editing Welcome to the CloudCannon Community! Omnichannel delivery is just marketing spin from API-based CMS companies Getting started with CloudCannon and Astro: Snippets and Collections Managing digital assets in CloudCannon: a guide to smart asset storage What is a static website? CloudCannon’s 2024 wrapped Getting started with CloudCannon and Astro: WYSIWYG blogging Jamstack vs. WordPress: reasons to make the change The top five static site generators for 2025 (and when to use them!) Free Jekyll themes for 2025: ten great community options Eleventy (11ty) vs. Hugo How to set up WYSIWYG editing with MkDocs Material The rise of static-first websites: why major brands are making the switch Watching your Core Web Vitals on Jamstack Understanding the difference between static, dynamic, and hybrid websites
Understanding CloudCannon's branching workflows and Proje...
2025-02-05 · via CloudCannon Blog

Let's dive into CloudCannon's most powerful features: branching workflows and Projects. Whether you're managing a complex website or working with a team, understanding how branching works in CloudCannon can make your content management process much smoother.

The basics: Publish Branches and Branch Sites Direct link to this section

Branching your sites is like having a sandbox where you can play around with changes before they go live. In CloudCannon terms, you have:

  • A Publish Branch — this could be your live site, the version that the whole world can see. Some developers like to call this the ‘production branch’ or ‘main’.
  • Branch Sites — private copies of your live site, where you can make and test changes before they're ready for primetime. These copied sites can be deleted once you’ve published your changes.

Confused about any other CloudCannon terms? Check out our simple glossary, below.

How to publish: choose your adventure Direct link to this section

CloudCannon gives you a range of publishing modes, and each has its place depending on your team's needs.

The quick route: publishing immediately Direct link to this section

Perfect for when you need changes to go live fast. Your team can push changes directly from your branched site to your Publish Branch without any approval process. It's quick, it's simple, and it gets the job done.

The review route: pull requests Direct link to this section

If you need a bit more oversight, pull requests are your friend. This mode requires another team member to review and approve changes before they go live. It's great for catching potential issues before they hit production, handing over to different departments (e.g. making sure that your legal team approves!), and triggering external builds and workflows.

If you're going the pull request route, here's how to make it smooth:

  1. Make your changes on the branch site
  2. Hit the Publish button
  3. Write a clear title and description (future you will thank present you!)
  4. Create the Pull Request

Your reviewers can then see a complete list of changes under the Changes tab before deciding to publish or close the request.

The middle ground: a staging branch Direct link to this section

Finally, my personal favorite, and the option we recommend to all teams using CloudCannon. Using a staging branch means you can instantly publish your changes to a private version of your site, which you and your team can use as a final check for quality control. (This is the approach we use internally for cloudcannon.com, for both code and content changes to the site.)

Note that a staging branch sits between your live site and your branch site(s) — so the staging site will be the designated Publish Branch for all of your branch sites. (And your live site will be the Publish Branch for your staging site!) If this sounds slightly complicated, check out the below section on Projects.

Staying in sync with your Publish Branch Direct link to this section

Here's another cool feature: CloudCannon lets you know when your Publish Branch has updates. You'll see a notification icon (with a downward arrow) on your Publish button when there are changes available.

Annotated screenshot showing CloudCannon publish button with an update available from Publish Branch

This can be super helpful when you have long-lived branches, when multiple team members are working on different features, or when you need to make sure your changes play nicely with others.

Pro tips for branch management Direct link to this section

Branch cleanup: By default, CloudCannon can automatically delete your branch sites after publishing. This keeps things tidy, especially if you create branches for specific changes.

Custom commit messages: You can set up templates to help maintain consistent communication across your team as you publish.

Disable publishing: Need to prevent a branch from publishing? No problem! You can disconnect it from your Publish Branch anytime through your Site Settings.

Projects Direct link to this section

If you really lean into the power of branching your website, or if you’re managing multiple sites within a larger organization, it’s possible that you’ll encounter a few problems trying to manage multiple sites. How can you keep track of everything?

Enter CloudCannon Projects, which make your workflow smooth and organized by grouping sites from the same repository. Projects let you create new sites more efficiently, and also automatically generate a visualization of your publishing workflow.

Here's a sample workflow, with a live site, a staging site, and branch site:

Annotated diagram of CloudCannon publishing workflow

Here's a pro tip that'll save your team tons of time: Related Links. Think of them as your project's speed dial. You can add quick links to analytics dashboards, documentation pages, frequently accessed collections, or directly to publishing workflows.

Diagram of CloudCannon related links

These shortcuts might seem small, but they can add up to significant time savings across your team. Setting up Related Links is simple: just head to your Project Settings, scroll to the Related Links section, and start adding links. Each one needs a display name and URL — that's it!

Customizing your Project Direct link to this section

Don't forget to make your Project page informative and useful. You can:

  • Give it a meaningful name that reflects the project's purpose
  • Add a display URL for quick access to the live site
  • Write a description to keep everyone on the same page
  • Set up Related Links

The power of flexibility Direct link to this section

Whether you're running a simple blog or managing a complex enterprise site, CloudCannon's Projects and branching workflows give you the control and flexibility you need. Start with what works for your team now, and know you can adjust as your needs evolve.

Remember, the best workflow is the one that works for your team. Don't be afraid to experiment and find what fits your process best.

Glossary Direct link to this section

CloudCannon term

What it means

Publish Branch

The site you're publishing your changes to. This can be your live website.

Staging site

A private copy of your live website, used for testing and quality control of any changes you’ve made. Branched sites should typically publish to your Staging site for final checks before you go live.

Branch site

A private copy of your website, ready for you to add or edit anything. By default, all branched sites are private, and only accessible to members of your Organization.

Branching

The process of copying a website.

Project

A method of organizing your Sites. More than a ‘folder’ for your sites, Projects formalize the process of copying and publishing your sites, and enable more efficient publishing workflows for your team.

Saving

How your changes are recorded to your site. CloudCannon will remember a lot of changes at once, even without saving, but your changes need to be saved before they’re published. (And if you work in a team, it’s generally good practice to save your changes as you work!)

Publishing

The process by which you make your changes ‘live’. Depending on how your publishing workflow is set up, clicking ‘Publish’ can publish your changes directly to your staging site, or directly to your live site.

Pull Request

A formal request for a team member to approve your changes.

Organization

Your team! By default, only Organization members can see private (branched or staging) sites created within CloudCannon. You can define the roles and permissions of each team member.