ActiveRegistration is a robust Rails engine designed to seamlessly integrate secure user registration with email confirmation into Rails applications (version 8+). Leveraging the Rails Authentication Generator, this gem simplifies the process of adding registration features while ensuring a secure user experience.

Key Features

• Streamlined Registration Flow: Enables a comprehensive sign-up process with essential email confirmation steps.
• Email Confirmation with Token Expiration: Ensures that registration tokens are time-sensitive for added security.
• Easy Integration: Compatible with existing User models created using the Rails Authentication Generator, making it simple to implement without extensive configuration.
• Customizable Views: Automatically generates views that can be easily tailored to meet specific design requirements.

Usage

To utilize ActiveRegistration in a Rails application, include the gem in the application's Gemfile:

gem "active_registration"

Once added, run the following command to set up the generator:

rails generate active_registration:install

For database updates, execute:

rails db:migrate

Configuration

Development Environment

For developers, integrating letter_opener allows email previews to be sent directly in the browser:

# Gemfile
gem 'letter_opener', group: :development

Production Environment

To set up the gem for production, configure your SMTP settings:

# config/environments/production.rb
config.action_mailer.delivery_method = :smtp
config.action_mailer.smtp_settings = {
  address:              'smtp.yourprovider.com',
  port:                 587,
  user_name:            ENV['SMTP_USER'],
  password:             ENV['SMTP_PASSWORD'],
  authentication:       :plain,
  enable_starttls_auto: true
}

Contribution Guidelines

ActiveRegistration welcomes contributions from the developer community. To contribute, fork the project, create your feature branch, commit changes, and submit a pull request. This collaborative approach ensures ongoing improvement and enhancement of the gem.