OneFlow is a Jekyll theme for creating modern one-page websites, delivered as a fork-and-clone GitHub repository instead of a gem. The theme provides a complete Jekyll site structure that you personalize, with a focus on simplicity and accessibility.
What is the OneFlow Jekyll Theme?
OneFlow is a Jekyll theme designed to build clear and practical one-page websites. It takes a standard Jekyll project and turns it into a single-page site with customizable sections. The theme is distributed as a ready-to-use GitHub repository by Per Starke Webdev, which you can fork, rename, and directly edit, or download as a zip file. It is not a classic gem-based theme, so all template files are visible and editable from the start.
Key Features
- Fork-and-clone distribution — the theme is a complete GitHub repository, so you can fork it, rename it to suit your project, and start editing without gem dependencies.
- Docker-based development — with Bundler and Docker installed, run
docker compose upto serve the site locally athttp://0.0.0.0:4000/and see changes in real time. - Extensive customization options — the theme offers many design and layout options, letting you match your own or your client's preferred structure.
- Version 1.1 updates — adds a default 404 page and fixes responsiveness of the page hero on mobile landscape screens.
- Example sites — the theme website and two example deployments (example one and example two) demonstrate different design possibilities.
- Full documentation — detailed instructions are available at perstarke-webdev.de/oneflow-jekyll-theme.
- Community visibility — featured on Jamstackthemes and jekyll-themes.com, and used to create the arc42 Trainings dates page at trainings.arc42.org.
Who is the OneFlow theme for?
- Freelance developers and designers who need a fast, clean starting point for client one-page websites.
- Jekyll users who prefer working with a full repository they can inspect and customize rather than a gem-based theme.
- Project teams that want a simple single-page site for announcements, trainings, or product landing pages, as shown by the arc42 Trainings usage.
What can you do with OneFlow?
- Small businesses: create a one-page marketing site with sections for services, about, and contact information.
- Event organizers: publish a single-page landing with event details and agenda.
- Developers: fork the theme to build a personal portfolio or project showcase with a modern one-page layout.
How does OneFlow work?
After forking and cloning the repository, install Bundler and Docker. Run docker compose up from the local repository, and your site will be available at http://0.0.0.0:4000/ in any browser. Edit the Jekyll files to change content and structure, and the site rebuilds automatically.
FAQ
Is OneFlow free?
OneFlow is open source and freely available for any use. You can fork the GitHub repository or download the theme as a zip file directly from the theme website.
Do I need to use Docker to run OneFlow?
Docker is the documented workflow for local development, but since OneFlow is a standard Jekyll site, you can also run it with jekyll serve if you have Ruby and Jekyll installed.
Can OneFlow be used for multi-page websites?
No, OneFlow is intentionally designed as a one-page theme. It works best for single-page sites where all content is organized into sections on one page.
Where can I find the full documentation?
Extensive documentation is hosted at perstarke-webdev.de/oneflow-jekyll-theme, covering setup, customization, and deployment.
