Foundry

Hosting guide

Put your site on GitHub Pages.

Portfolios, personal sites and anyone who already has a GitHub account.
  1. 1

    Create a repository

    On github.com, click New repository and make it public.

  2. 2

    Upload the files

    Add file → Upload files, and drag in everything inside the template folder, so index.html sits at the top level.

  3. 3

    Turn on Pages

    Settings → Pages → Build and deployment → Deploy from a branch → main, / (root) → Save.

  4. 4

    Visit your site

    After a minute it's live at your-username.github.io/repository-name. Name the repository your-username.github.io to serve it at the root.

  5. 5

    Add your domain

    In the same Pages settings, enter a Custom domain and follow the DNS instructions GitHub shows.

Good to know

  • GitHub Pages only serves static files, so forms need a service such as Formspree (see the forms guide).
  • Helix: Helix is a Next.js project rather than plain HTML, so it needs a host that runs Next.js: Vercel, Netlify or Firebase App Hosting.