# Perron

Static site generator for Ruby on Rails that builds content collections from markdown or ERB into a static site.


Source: https://findsoftware.frbit.cloud/perron/
Last reviewed: 2026-10-23
Listed since: 2026-10-23

## Record

### Links

- home: https://perron.railsdesigner.com
- repository: https://github.com/Rails-Designer/perron
- docs: https://perron.railsdesigner.com/docs/

### Identity

- status: active
- maintainer: Rails Designer
- maintainerType: unknown
- parent: unknown
- firstRelease: 2025
- hqCountry: unknown

### Kind

- category: ssg
- hosting: static
- language: ruby
- runtime: ruby
- runtimeMin: ruby 3.4
- basedOn: unknown

### Content

- contentStore: flat-file
- databases: unknown
- adminUi: unknown
- headlessApi: unknown
- templating: erb, markdown
- i18n: unknown

### Rendering and deploy

- runsAs: static, local
- renderingModes: static
- installMethod: bundle add perron, then bin/rails perron:install

### License

- licenseModel: open-source
- license: MIT

### Releases

- currentMajor: 1
- latestReleaseDate: 2026-06-24

### Adoption

- githubStargazers: 158
- packagistDownloads: not applicable
- npmWeeklyDownloads: not applicable
- contributors: 6
- pluginCount: unknown
- packagistMonthlyDownloads: unknown
- ecosystemsMonthlyDownloads: unknown
- httpArchiveSites: unknown
- wordpressActiveInstalls: unknown
- dependentRepos: unknown
- dependentPackages: unknown

### Sources

- urls: https://perron.railsdesigner.com/ (read 2026-10-23)
- urls: https://api.github.com/repos/Rails-Designer/perron (read 2026-10-23)
- urls: https://perron.railsdesigner.com/docs/ (read 2026-10-23)
- maintainer: https://raw.githubusercontent.com/Rails-Designer/perron/main/LICENSE.txt (read 2026-10-23)
- language: https://api.github.com/repos/Rails-Designer/perron (read 2026-10-23)
- category: https://perron.railsdesigner.com/ (read 2026-10-23)
- runtime: https://perron.railsdesigner.com/docs/quickstart/ (read 2026-10-23)
- runtimeMin: https://rubygems.org/api/v1/versions/perron.json (read 2026-10-23)
- installMethod: https://perron.railsdesigner.com/docs/quickstart/ (read 2026-10-23)
- renderingModes: https://perron.railsdesigner.com/docs/deploy/ (read 2026-10-23)
- runsAs: https://perron.railsdesigner.com/docs/deploy/ (read 2026-10-23)
- runsAs: https://perron.railsdesigner.com/docs/quickstart/ (read 2026-10-23)
- templating: https://rubygems.org/api/v1/gems/perron.json (read 2026-10-23)
- contentStore: https://perron.railsdesigner.com/docs/quickstart/ (read 2026-10-23)
- license: https://github.com/Rails-Designer/perron/blob/main/README.md (read 2026-10-23)
- license: https://github.com/Rails-Designer/perron/blob/main/README.md (read 2026-10-23)
- firstRelease: https://api.github.com/repos/Rails-Designer/perron/releases (read 2026-10-23)
- currentMajor: https://api.github.com/repos/Rails-Designer/perron/releases (read 2026-10-23)
- latestReleaseDate: https://api.github.com/repos/Rails-Designer/perron/releases (read 2026-10-23)
- githubStargazers: https://api.github.com/repos/Rails-Designer/perron (read 2026-10-23)
- contributors: https://api.github.com/repos/Rails-Designer/perron/contributors (read 2026-10-23)

## Notes

Perron is a static site generator for Ruby on Rails, built on Rails and installed into a Rails application with bundle add perron and the perron:install task. Content lives in the application as markdown or ERB files, grouped into collections, and the perron:build task writes the finished site to an output directory. The library requires Ruby 3.4 or newer.

## Worth knowing

Perron has two modes. The default standalone mode produces a static site for build-based hosts such as Netlify. The integrated mode adds static pages to a live Rails application, which then runs on a Rails host such as Heroku.

---

Data licensed CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Attributes are recorded, never scored; absent means unknown.
Credit, in full: FindSoftware, CC BY 4.0