# Nuxt Umbu

[![npm version](https://img.shields.io/npm/v/nuxt-umbu/latest.svg?style=flat-square&colorA=18181B&colorB=28CF8D)](https://www.npmjs.com/package/nuxt-umbu)
[![npm downloads](https://img.shields.io/npm/dt/nuxt-umbu.svg?style=flat-square&colorA=18181B&colorB=28CF8D)](https://npmx.dev/package/nuxt-umbu)
[![Documentation](https://img.shields.io/badge/docs-4sllan.github.io-28CF8D?style=flat-square&colorA=18181B)](https://4sllan.github.io/nuxt-umbu/)

Nuxt Umbu is an authentication module for **Nuxt** designed to work seamlessly with **Laravel Sanctum** and **Laravel Passport**.

It provides a secure and SSR-compatible authentication layer with built-in support for cookies, tokens, middleware, composables, and optional Two-Factor Authentication (2FA).

## Features

- 🔐 Authentication for **Nuxt**
- ⚡ Built for **SSR and SPA**
- 🍪 Secure **HTTP-only cookie authentication (Sanctum)**
- 🔑 **OAuth2 token authentication (Passport)**
- 🧩 Strategy-based architecture
- 🛡 Built-in **CSRF protection**
- 📦 `$auth` instance available globally
- 🧠 Route middleware for protected pages
- 🔄 Automatic user fetching
- 🔑 Optional **Two-Factor Authentication (2FA)**
- 🪝 Extensible for future authentication providers

---