# heartcombo/devise architecture

> Architecture diagram of the GitHub repository heartcombo/devise, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/heartcombo/devise
- Repository: https://github.com/heartcombo/devise

## Overview

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: [`lib/devise/rails/routes.rb`](https://github.com/heartcombo/devise/blob/main/lib/devise/rails/routes.rb) (Devise routes), [`lib/devise/models/authenticatable.rb`](https://github.com/heartcombo/devise/blob/main/lib/devise/models/authenticatable.rb) (Authentication model), [`app/controllers/devise/sessions_controller.rb`](https://github.com/heartcombo/devise/blob/main/app/controllers/devise/sessions_controller.rb) (Sessions controller), [`app/controllers/devise/registrations_controller.rb`](https://github.com/heartcombo/devise/blob/main/app/controllers/devise/registrations_controller.rb) (Registration controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_rails["Rails interface"]
  node_routes["Devise routes<br/>[routes.rb]"]
  node_controller_base["Controller base"]
  node_sessions["Sessions controller"]
  node_registrations["Registration controller"]
  node_confirmations["Confirmation controller"]
  node_callbacks["OmniAuth callbacks"]
end

subgraph group_auth["Authentication core"]
  node_warden["Warden"]
  node_failure["Failure handling<br/>[failure_app.rb]"]
  node_core["Devise configuration<br/>[devise.rb]"]
  node_strategy["Database strategy"]
  node_authenticatable["Authentication model<br/>[authenticatable.rb]"]
  node_database_model["Password model"]
end

subgraph group_lifecycle["Account lifecycle"]
  node_confirmable["Confirmation module<br/>[confirmable.rb]"]
  node_recoverable["Password recovery<br/>[recoverable.rb]"]
  node_registerable["Registration module<br/>[registerable.rb]"]
  node_lockable["Account lockout<br/>[lockable.rb]"]
  node_rememberable["Remembered sessions<br/>[rememberable.rb]"]
end

subgraph group_extensions["Modules and integrations"]
  node_omniauthable["OmniAuth module<br/>[omniauthable.rb]"]
  node_trackable["Sign-in tracking<br/>[trackable.rb]"]
  node_timeoutable["Session timeout<br/>[timeoutable.rb]"]
  node_validatable["Credential validation<br/>[validatable.rb]"]
  node_orm["ORM adapters<br/>[orm.rb]"]
  node_mailer["Devise mailer<br/>[mailer.rb]"]
end

node_user(("Requesting user"))

node_user -->|"requests auth"| node_routes
node_routes -.->|"routes to"| node_sessions
node_routes -.->|"routes to"| node_registrations
node_routes -.->|"routes to"| node_confirmations
node_routes -.->|"routes to"| node_callbacks
node_sessions -->|"inherits from"| node_controller_base
node_registrations -->|"inherits from"| node_controller_base
node_confirmations -->|"inherits from"| node_controller_base
node_sessions -->|"authenticates with"| node_warden
node_warden -->|"dispatches strategy"| node_strategy
node_strategy -->|"checks password"| node_database_model
node_database_model -.->|"extends authentication"| node_authenticatable
node_sessions -.->|"uses on failure"| node_failure
node_core -->|"configures"| node_warden
node_registrations -.->|"manages accounts"| node_registerable
node_confirmations -.->|"confirms accounts"| node_confirmable
node_confirmable -.->|"sends instructions"| node_mailer
node_recoverable -.->|"sends reset instructions"| node_mailer
node_lockable -.->|"supports email unlock"| node_mailer
node_strategy -.->|"supports remember me"| node_rememberable
node_callbacks -.->|"handles provider sign-in"| node_omniauthable
node_authenticatable -.->|"supports tracking"| node_trackable
node_authenticatable -.->|"supports expiration"| node_timeoutable
node_authenticatable -.->|"supports validation"| node_validatable
node_authenticatable -.->|"uses ORM adapters"| node_orm

click node_routes "https://github.com/heartcombo/devise/blob/main/lib/devise/rails/routes.rb"
click node_controller_base "https://github.com/heartcombo/devise/blob/main/app/controllers/devise_controller.rb"
click node_sessions "https://github.com/heartcombo/devise/blob/main/app/controllers/devise/sessions_controller.rb"
click node_registrations "https://github.com/heartcombo/devise/blob/main/app/controllers/devise/registrations_controller.rb"
click node_confirmations "https://github.com/heartcombo/devise/blob/main/app/controllers/devise/confirmations_controller.rb"
click node_callbacks "https://github.com/heartcombo/devise/blob/main/app/controllers/devise/omniauth_callbacks_controller.rb"
click node_failure "https://github.com/heartcombo/devise/blob/main/lib/devise/failure_app.rb"
click node_core "https://github.com/heartcombo/devise/blob/main/lib/devise.rb"
click node_strategy "https://github.com/heartcombo/devise/blob/main/lib/devise/strategies/database_authenticatable.rb"
click node_authenticatable "https://github.com/heartcombo/devise/blob/main/lib/devise/models/authenticatable.rb"
click node_database_model "https://github.com/heartcombo/devise/blob/main/lib/devise/models/database_authenticatable.rb"
click node_confirmable "https://github.com/heartcombo/devise/blob/main/lib/devise/models/confirmable.rb"
click node_recoverable "https://github.com/heartcombo/devise/blob/main/lib/devise/models/recoverable.rb"
click node_registerable "https://github.com/heartcombo/devise/blob/main/lib/devise/models/registerable.rb"
click node_lockable "https://github.com/heartcombo/devise/blob/main/lib/devise/models/lockable.rb"
click node_rememberable "https://github.com/heartcombo/devise/blob/main/lib/devise/models/rememberable.rb"
click node_omniauthable "https://github.com/heartcombo/devise/blob/main/lib/devise/models/omniauthable.rb"
click node_trackable "https://github.com/heartcombo/devise/blob/main/lib/devise/models/trackable.rb"
click node_timeoutable "https://github.com/heartcombo/devise/blob/main/lib/devise/models/timeoutable.rb"
click node_validatable "https://github.com/heartcombo/devise/blob/main/lib/devise/models/validatable.rb"
click node_orm "https://github.com/heartcombo/devise/blob/main/lib/devise/orm.rb"
click node_mailer "https://github.com/heartcombo/devise/blob/main/app/mailers/devise/mailer.rb"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_routes,node_controller_base,node_sessions,node_registrations,node_confirmations,node_callbacks,node_user toneBlue
class node_warden,node_failure,node_core,node_strategy,node_authenticatable,node_database_model toneAmber
class node_confirmable,node_recoverable,node_registerable,node_lockable,node_rememberable toneMint
class node_omniauthable,node_trackable,node_timeoutable,node_validatable,node_orm,node_mailer toneRose
```

## Components

### Rails interface

- [Devise routes](https://github.com/heartcombo/devise/blob/main/lib/devise/rails/routes.rb): `lib/devise/rails/routes.rb`
- [Controller base](https://github.com/heartcombo/devise/blob/main/app/controllers/devise_controller.rb): `app/controllers/devise_controller.rb`
- [Sessions controller](https://github.com/heartcombo/devise/blob/main/app/controllers/devise/sessions_controller.rb): `app/controllers/devise/sessions_controller.rb`
- [Registration controller](https://github.com/heartcombo/devise/blob/main/app/controllers/devise/registrations_controller.rb): `app/controllers/devise/registrations_controller.rb`
- [Confirmation controller](https://github.com/heartcombo/devise/blob/main/app/controllers/devise/confirmations_controller.rb): `app/controllers/devise/confirmations_controller.rb`
- [OmniAuth callbacks](https://github.com/heartcombo/devise/blob/main/app/controllers/devise/omniauth_callbacks_controller.rb): `app/controllers/devise/omniauth_callbacks_controller.rb`

### Authentication core

- **Warden**
- [Failure handling](https://github.com/heartcombo/devise/blob/main/lib/devise/failure_app.rb): `lib/devise/failure_app.rb`
- [Devise configuration](https://github.com/heartcombo/devise/blob/main/lib/devise.rb): `lib/devise.rb`
- [Database strategy](https://github.com/heartcombo/devise/blob/main/lib/devise/strategies/database_authenticatable.rb): `lib/devise/strategies/database_authenticatable.rb`
- [Authentication model](https://github.com/heartcombo/devise/blob/main/lib/devise/models/authenticatable.rb): `lib/devise/models/authenticatable.rb`
- [Password model](https://github.com/heartcombo/devise/blob/main/lib/devise/models/database_authenticatable.rb): `lib/devise/models/database_authenticatable.rb`

### Account lifecycle

- [Confirmation module](https://github.com/heartcombo/devise/blob/main/lib/devise/models/confirmable.rb): `lib/devise/models/confirmable.rb`
- [Password recovery](https://github.com/heartcombo/devise/blob/main/lib/devise/models/recoverable.rb): `lib/devise/models/recoverable.rb`
- [Registration module](https://github.com/heartcombo/devise/blob/main/lib/devise/models/registerable.rb): `lib/devise/models/registerable.rb`
- [Account lockout](https://github.com/heartcombo/devise/blob/main/lib/devise/models/lockable.rb): `lib/devise/models/lockable.rb`
- [Remembered sessions](https://github.com/heartcombo/devise/blob/main/lib/devise/models/rememberable.rb): `lib/devise/models/rememberable.rb`

### Modules and integrations

- [OmniAuth module](https://github.com/heartcombo/devise/blob/main/lib/devise/models/omniauthable.rb): `lib/devise/models/omniauthable.rb`
- [Sign-in tracking](https://github.com/heartcombo/devise/blob/main/lib/devise/models/trackable.rb): `lib/devise/models/trackable.rb`
- [Session timeout](https://github.com/heartcombo/devise/blob/main/lib/devise/models/timeoutable.rb): `lib/devise/models/timeoutable.rb`
- [Credential validation](https://github.com/heartcombo/devise/blob/main/lib/devise/models/validatable.rb): `lib/devise/models/validatable.rb`
- [ORM adapters](https://github.com/heartcombo/devise/blob/main/lib/devise/orm.rb): `lib/devise/orm.rb`
- [Devise mailer](https://github.com/heartcombo/devise/blob/main/app/mailers/devise/mailer.rb): `app/mailers/devise/mailer.rb`

### Other components

- **Requesting user**

## Connections

- Requesting user → Devise routes: requests auth (evidence: `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 (evidence: `app/controllers/devise/sessions_controller.rb`)
- Registration controller → Controller base: inherits from (evidence: `app/controllers/devise/registrations_controller.rb`)
- Confirmation controller → Controller base: inherits from (evidence: `app/controllers/devise/confirmations_controller.rb`)
- Sessions controller → Warden: authenticates with (evidence: `app/controllers/devise/sessions_controller.rb`)
- Warden → Database strategy: dispatches strategy (evidence: `lib/devise/strategies/database_authenticatable.rb`)
- Database strategy → Password model: checks password (evidence: `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
