Note: This devoloper portal is inspired from Cloudflare developer portal and we have forked their repository to create this.
You must have Hugo installed on your system and available in your $PATH as a global binary. Most operating systems are supported – follow the relevant Install Hugo instructions for your operating system guides to get started.
Important: This project is built with version
0.92.2+extendedbut0.92.xis the minimum required version. You may (probably) use a newer version of Hugo, but will be subject to any Hugo changes.
You must also have a recent version of Node.js (14+) installed. You may use Volta, a Node version manager, to install the latest version of Node and npm, which is a package manager that is included with node's installation.
$ curl https://get.volta.sh | bash
$ volta install nodeFinally, you will need to install the Node.js dependencies for this project using npm or another package manager:
$ npm installWhen making changes to the site, including any content changes, you may run a local development server by running the following command:
$ npm run devThis spawns a server that will be accessible via http://localhost:1313 in your browser. Additionally, any changes made within the project – including content/** changes – will automatically reload your browser tab(s), allowing you to instantly preview your changes!
Additionally, this project includes a CI step for ensuring consistent code style. This applies to all files within the project, including markdown (*.md) files, but will not affect the content itself or the content's output display. To see the style error(s), you may run:
$ npm run lintFinally, some of these code-style errors may be fixed automatically. To do so, you may run:
$ npm run formatOur docs are deployed using Cloudflare Pages. Every commit pushed to production will automatically deploy to developers.squadcast.com, and any pull requests opened will have a corresponding staging URL available in the pull request comments.
Except as otherwise noted, Squadcast and any contributors grant you a license to the Squadcast Developer Documentation and other content in this repository under the Creative Commons Attribution 4.0 International Public License, see the LICENSE file, and grant you a license to any code in the repository under the MIT License.