Invariable is a straightforward, easy-to-use application designed to help you create and manage static websites. Crafted with love in Elixir, it incorporates a few select tools to ensure your website building process is as smooth and efficient as possible:
mix.ex
file at the root,package.json
file within the assets directory.Invariable aims to simplify the website creation process, allowing you to use GitHub Actions to automatically generate a static site. This site can then be hosted directly from your GitHub repository as a GitHub Page, following the straightforward setup process detailed below.
/example_content_src/
and put them in /content_src
cp -r example_content_src/* content_src
mix site.build
mix run --no-halt
Generate a Personal Access Token (PAT) for CI/CD:
Create a Secret for Your Repository:
PAT
and paste in your generated token.Prepare Your Content:
web
.content_src/site_config.yml
with your site's name, description, and clean up any placeholder navigation links.Configure GitHub Actions:
web
branch, adjust the .github/workflows/deploy.yml
file to trigger on pushes to the web
branch.Launch Your Site:
gh-pages
branch will be created.gh-pages
branch in your repository settings.Congratulations! 🎉 Your site should now be live.
.github/workflows/deploy.yml
. Uncomment and modify the cname
field as needed. If not using a custom domain, ensure your repository name meets GitHub Pages' requirements.Invariable is all about making web development accessible and manageable, whether you're a seasoned developer or new to the scene. Enjoy building your site!