Project

form_guard

0.0
The project is in a healthy, maintained state
form_guardamigobg/form_guardHomepageDocumentationSource CodeBug Tracker
FormGuard provides a simple way to prevent bot form submissions in Rails applications using honeypot fields and timestamp-based validation.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
 Popularity
Downloads
167
Stars
1
Forks
0
Watchers
0
 Releases
Current version
0.1.0
Total releases
1
First release
2025-06-05
Latest release
2025-06-05
 Development
Primary Language
Ruby
Licenses
MIT
Average date of last 50 commits
2025-06-03
Reverse Dependencies
0

 Dependencies

Development

actionpack
~> 6.0
actionview
~> 6.0
minitest
~> 5.16

Runtime

activesupport
>= 6.0, < 8.0
rails
>= 6.0, < 8.0
 Project Readme

Form Guard

Form Guard is a lightweight gem to protect your forms from bots and spammy submissions using a simple and effective honeypot + timing strategy.

Installation

Add this line to your application's Gemfile:

gem 'form_guard'

And then execute:

bundle install

Usage

  1. Add hidden guard field to your forms:
<%= form_guard_fields %>

How it works

  • Bots tend to fill all fields — including hidden ones. If the honeypot is filled, the submission is rejected.

  • Bots submit instantly. If the form is submitted too quickly (under 2 seconds), it’s probably a bot.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/amigobg/form_guard.

License

The gem is available as open source under the terms of the MIT License.