@magikauth/core/README.md

MagikAuth SDK – Auth in 2 min. Plug & Play auth for any JS framework.

# 🔒 MagikAuth Core SDK

> ⚡️ Auth in 2 minutes – Plug & Play authentication SDK. Framework-agnostic. Your Auth, Your Rules.

`@magikauth/core` is a lightweight, universal JavaScript/TypeScript SDK that helps developers integrate secure authentication (OTP, password, magic URL) into any frontend framework like **Svelte, React, Vue, Next.js, Astro, Nuxt**, etc., with **zero backend boilerplate**.

---

## ✨ Features

- ✅ Email + OTP login (passwordless)
- 🔐 Optional password set/reset flows
- 🔗 Email + Password + Email Verification flow
- 🧠 Built-in session/token management (browser/localStorage)
- 🌐 SSR-compatible, framework-agnostic
- 🧩 Easily pluggable into custom UIs — no forced components
- 🔑 Connects securely to MagikAuth API via your project config
- 📦 Works with your SMTP or MagikSMTP
- 🔍 Developer dashboard with analytics, user/session management & webhooks *(coming soon)*

---

## 🚀 Quickstart

### 1. 📦 Install SDK

```bash
npm install @magikauth/core
# or
yarn add @magikauth/core