How heartcombo/devise works
Devise is a modular Rails/Rack authentication system built on Warden. A typical sign-in request reaches a generated Devise route and sessions controller, which asks Warden to authenticate; the database strategy checks the model’s password and the controller signs the user in. Separate account-lifecycle modules cover registration, confirmation, recovery, lockout, and remembered sessions, while OmniAuth, tracking, timeout, validation, and ORM support extend the core. The README documents several capabilities whose runtime wiring was not sampled, so those links are marked unverified rather than inferred as calls.
Main entry points: routes.rb Devise routes · authenticatable.rb Authentication model · sessions_controller.rb Sessions controller · registrations_controller.rb Registration controller
Components 24
Rails interface
- Devise routes
lib/devise/rails/routes.rb - Controller base
app/controllers/devise_controller.rb - Sessions controller
app/controllers/devise/sessions_controller.rb - Registration controller
app/controllers/devise/registrations_controller.rb - Confirmation controller
app/controllers/devise/confirmations_controller.rb - OmniAuth callbacks
app/controllers/devise/omniauth_callbacks_controller.rb
Authentication core
- Warden
- Failure handling
lib/devise/failure_app.rb - Devise configuration
lib/devise.rb - Database strategy
lib/devise/strategies/database_authenticatable.rb - Authentication model
lib/devise/models/authenticatable.rb - Password model
lib/devise/models/database_authenticatable.rb
Account lifecycle
- Confirmation module
lib/devise/models/confirmable.rb - Password recovery
lib/devise/models/recoverable.rb - Registration module
lib/devise/models/registerable.rb - Account lockout
lib/devise/models/lockable.rb - Remembered sessions
lib/devise/models/rememberable.rb
Modules and integrations
- OmniAuth module
lib/devise/models/omniauthable.rb - Sign-in tracking
lib/devise/models/trackable.rb - Session timeout
lib/devise/models/timeoutable.rb - Credential validation
lib/devise/models/validatable.rb - ORM adapters
lib/devise/orm.rb - Devise mailer
app/mailers/devise/mailer.rb
Other components
- Requesting user
Connections 25
- Requesting user → Devise routes: requests auth
lib/devise/rails/routes.rb - Devise routes → Sessions controller: routes to
- Devise routes → Registration controller: routes to
- Devise routes → Confirmation controller: routes to
- Devise routes → OmniAuth callbacks: routes to
- Sessions controller → Controller base: inherits from
app/controllers/devise/sessions_controller.rb - Registration controller → Controller base: inherits from
app/controllers/devise/registrations_controller.rb - Confirmation controller → Controller base: inherits from
app/controllers/devise/confirmations_controller.rb - Sessions controller → Warden: authenticates with
app/controllers/devise/sessions_controller.rb - Warden → Database strategy: dispatches strategy
lib/devise/strategies/database_authenticatable.rb - Database strategy → Password model: checks password
lib/devise/strategies/database_authenticatable.rb - Password model → Authentication model: extends authentication
- Sessions controller → Failure handling: uses on failure
- Devise configuration → Warden: configures
- Registration controller → Registration module: manages accounts
- Confirmation controller → Confirmation module: confirms accounts
- Confirmation module → Devise mailer: sends instructions
- Password recovery → Devise mailer: sends reset instructions
- Account lockout → Devise mailer: supports email unlock
- Database strategy → Remembered sessions: supports remember me
- OmniAuth callbacks → OmniAuth module: handles provider sign-in
- Authentication model → Sign-in tracking: supports tracking
- Authentication model → Session timeout: supports expiration
- Authentication model → Credential validation: supports validation
- Authentication model → ORM adapters: uses ORM adapters