Buildmine · Take it live

A website you can
take with you.

Your ZIP contains a ready-built website and the source to change it. Publishing takes a few account setup steps; the included workflow handles later builds.

← Back to the builder · Try the example kit

First, check your files.

  1. Unzip your website kit and open site/index.html. Check your public text and every link.
  2. The site/ folder is ready to publish. site.json contains your public content; the remaining files let you regenerate or customize it.
  3. Keep your private .buildmine.json project, text brief, and original résumé out of the hosting folder and public repository.

Use your own GitHub Pages site.

  1. Create a new public repository in your GitHub account. Use any project name, or YOUR-USERNAME.github.io for your account’s root site.
  2. Upload the kit’s source files to the repository root. Include the hidden .github/workflows/pages.yml file. If the upload picker hides it, use Add file → Create new file, enter that full path, and paste the workflow from your kit. Read DEPLOY.md for the exact file list.
  3. Open Settings → Pages. Under Build and deployment, set Source to GitHub Actions.
  4. In Actions, run Publish personal site, or push a change to main. Wait for the deployment to finish. Open the URL GitHub shows.
  5. Test Home, About, Hello, and your contact links. Edit site.json and commit your changes to update the live site.

GitHub Free supports Pages for public repositories. Your repository and site content are public. GitHub Pages has usage limits and is intended for suitable static sites; it is not a platform for operating a commercial SaaS or arbitrary customer hosting. Check GitHub’s current limits and permitted uses.

Prefer another host?

Upload the contents of site/ to a static host you choose. No server or database is required. To regenerate after editing your source, install Node.js 22.13 or later and run node generate.mjs. Your kit includes an AI customization prompt, too.

A custom domain is optional and usually costs money. Connect it through your chosen host’s domain settings. Buildmine does not buy domains, configure DNS, or request access tokens.

What about a named page here?

Alex Rivera’s fictional example demonstrates a static named page. Self-service accounts, slug ownership, and automatic publishing to Drew’s domain are not part of this release. Your share link carries its data in the URL; it is not a saved or revocable account. Keep a downloaded copy.

Made something you want to show? Send Drew your already-public link and say whether you want your name and site included in a future showcase. Nothing is listed automatically.

Official GitHub Pages setup guide ↗