Skip to content

dsillman2000/swimmer

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

230 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Swimmer

Swimmer is an opinionated yet invitingly simple Jekyll theme that extends and builds off of Poole, the foundational Jekyll setup by @mdo. The name comes from "David's Poole" → David Schwimmer → Swimmer.

Poole provides a clear and concise foundation for any Jekyll site. Swimmer takes that foundation and adds a dedicated landing page, mobile sidebar, dual-mechanism dark mode, self-hosted variable fonts, and Tailwind CSS v4 styling.

See it live at swimmer.dsillman.com.

Swimmer light mode Swimmer dark mode

Features

  • Dedicated landing pageindex.md serves as a standalone homepage with logo, not a paginated post listing
  • Minimalist masthead — just site title, tagline, and dark mode toggle; no navigation bar
  • Post sidebar — hamburger-triggered overlay on mobile, fixed-position list on desktop (≥75rem), showing the 10 most recent posts and any related posts
  • Dark mode — respects prefers-color-scheme, offers a manual toggle (sun/moon icons), persists preference in localStorage, and prevents flash of wrong theme
  • Self-hosted variable fonts — Inter (body) and Roboto Mono (code), preloaded as WOFF2
  • Tailwind CSS v4 — modular CSS via @tailwindcss/cli, compiled to a single minified styles.css
  • Syntax highlighting — Rouge with separate light and dark color schemes
  • Archive page — posts grouped by month/year
  • Atom/RSS feed — built-in atom.xml
  • SEOjekyll-seo-tag integrated in <head>

Contents

Usage

1. Install dependencies

$ make install

This runs bundle install and npm install. You'll need Ruby 3.3.0, Bundler, and Node (managed via fnm).

2. Running locally

$ make serve

Open http://localhost:4000 in your browser. The CSS will rebuild on changes automatically.

3. Production build

$ make build

Output goes to _site/.

4. Serving it up

Push your repo to GitHub and use GitHub Pages to host. Verify the baseurl option in _config.yml and CNAME if using a custom domain.

Development

CSS lives in _css/ as modular files compiled into styles.css. Edit the source files in _css/, then run make css (or use make serve for auto-rebuild).

To regenerate screenshots:

$ make screenshots

Credits

Swimmer extends and builds off of Poole, the foundational Jekyll setup by @mdo. The original Poole project also produced the Hyde and Lanyon themes.

Author

David Sillmandsillman.com · GitHub

Originally built as Poole by Mark Otto (@mdo).

License

Open sourced under the MIT license.

About

Fork of Poole (Jekyll theme) which I'm using for my personal website

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages

  • CSS 60.4%
  • HTML 25.1%
  • JavaScript 5.2%
  • Makefile 4.1%
  • Ruby 2.8%
  • Shell 2.4%