SourceCraft Sites

SourceCraft Sites is a tool for free static website hosting without the need to configure server infrastructure. Files for a published website are hosted in a public repository of a public SourceCraft organization.

A static website is built with such client-side technologies as HTML, CSS, and JavaScript. It may not contain any scripts that run on the web server side. You can use any static website generators, e.g., Jekyll, Hugo, Gatsby, etc.

Access to websites hosted in SourceCraft Sites is arranged over the secure HTTPS protocol. You do not need to upload your own TLS certificate.

Your website will be available at https://<organization_slug>.sourcecraft.site/<repository_name>.

SourceCraft Sites hosting is a great fit for portfolios, blogs, docs, landing pages, and more.

Sample landing page on SourceCraft Sites

The SourceCraft Sites configuration is set up for a particular repository and stored in a file named .sourcecraft/sites.yaml. A configuration stored in the main branch, e.g., master or main, applies to the entire repository.

The general configuration format for SourceCraft Sites in .sourcecraft/sites.yaml is as follows:

site:
  root: "<path_to_directory_with_website_files>"
  ref: "<branch_or_tag>"

Where:

• root: Absolute path from the repository root to the directory with website files. This is an optional parameter. By default, it is set to the repository root.

  Tip

  We recommend using index.html for your website homepage.

• ref: Name of the branch or tag whose files will be used to publish the static website. This is an optional parameter. By default, it is set to the repository’s main branch. Once you commit changes to the branch, the website will update automatically in a few minutes.

The platform offers the following features for managing your published website in SourceCraft Sites:

• Versioning with Git
• Publishing changes through pull requests
• Automatic build from source code using CI/CD

See also

• Hosting a static website from a repository using SourceCraft Sites
• SourceCraft resource relationships