Devise Authentication API

This repository is a Rails 7.1 API-only starter kit that shows how to build a token-based authentication layer using Devise and JWT.

🛠 Tech Stack

Layer	Choice
Framework	Rails 7.1 (API-only mode)
Auth	Devise + devise-jwt
DB	PostgreSQL
Serializer	jsonapi-serializer

---

🚀 Quick start (local)

# Clone & move in
$ git clone https://github.com/your-username/devise-authentication.git
$ cd devise-authentication

# Install gems
$ bundle install

# Create DBs & run migrations
$ rails db:create db:migrate



# Run the server
$ bin/rails server # => http://localhost:3000

Environment variables

The ONLY required env var is the JWT secret Devise will use to sign tokens. Add it to config/credentials.yml.enc (preferred) or export before boot:

bundle exec rails secret

#VSCode 
EDITOR='code --wait' rails credentials:edit
devise_jwt_secret_key: (copy and paste the generated secret here)

---

🔌 API Endpoints

Method	Path	Description	Headers / Body
POST	/signup	Create a new user	{"user": {"email": "fakeusertest@example3.com", "password": "securepassword", "name": "Fake User2"}}
POST	/login	Obtain a JWT	{"user": { "email": "fakeuser@example.com", "password": "securepassword" }}
DELETE	/logout	Revoke the current JWT	Authorization: Bearer <token>