The official website of ThreeFold Foundation.

Production: www.threefold.io (master branch)

Staging: www2.threefold.io (development branch)

Last Updated: September 2024

ThreeFold's Web Admins

It is highly important to follow this procedure to contribute to the website content.
WARNING: DO NOT commit straight into the master / development branches.

1. Feel free to create a new issue to report an error on the website, or if you have any suggestions on website improvements.

2. Make your own branch from the development branch. By creating a new branch from development you will be provided with the latest copy of the live website content at the staging site, www2.threefold.io.

3. Add your edits into your own branch via code editor locally, and push your local changes online. WARNING: DO NOT add your edits straight into master / development branch.

4. Create a PR to merge your own branch into development, and assign one of ThreeFold's Web Admins on your PR as reviewer, or assign @sasha-astiadi as reviewer.

5. When PR is approved, you can see your changes on staging env on www2.threefold.io (development branch)

6. Admin will then create a PR to merge development into into master (production branch)

7. When PR is approved, you can see your changes live on production www.threefold.io (master branch).

While contributing content to this site doesn't strictly require setting up a development environment, it will allow you to preview your changes and that's super handy.

To do that, the following prerequisites are needed:

• macOS or Linux
• Zola

Then clone the repository recursively to also pull in contents of threefold_data:

#if you don't have hero installed yet, run the following commands
curl https://raw.githubusercontent.com/freeflowuniverse/crystallib/development/scripts/install_hero.sh > /tmp/hero_install.sh
bash /tmp/hero_install.sh

#install zola & tailwind
hero installers -n zola

#get this repo be careful --pr will remove all local changes (pull reset), -b development means we are on the development branch
hero git pull -u https://github.com/threefoldfoundation/www_threefold_io -b development -pr

#cd to the directory
eval $(hero git cd -u https://github.com/threefoldfoundation/www_threefold_io)

bash build.sh

Finally, start a browsable local copy of the site that will respond to changes in the source files like this:

zola serve

Zola will display a local address such as https://127.0.0.1:1111 which you can click or copy and paste into your browser to view the site on your own machine.

That's it—have fun!