My learnings and prototypes that I would like to share.
- Ruby (use the version installed locally or via rbenv/rvm) with Bundler available
- Node.js 16+ (asset watcher and build scripts)
Run these once per environment:
gem install bundler # skip if Bundler is already available
bundle install
npm installBy default Bundler installs gems into the global path. To keep them vendored, run bundle config set --local path 'vendor/bundle' before bundle install.
Launch Jekyll in watch mode with livereload:
bundle exec jekyll serve --livereloadThis serves the site at http://127.0.0.1:4000. Keep the command running while you edit Markdown posts, layouts, or data files; changes trigger automatic rebuilds and browser refreshes. If you tweak Sass or JavaScript bundles, start the theme's helper in another terminal:
npm run devRun Jekyll's build and doctor checks to ensure templates render cleanly and config issues are caught:
bundle exec jekyll doctor
bundle exec jekyll buildThe build output appears in _site/. Commit only source files—leave _site/ untracked when pushing to GitHub.
