# supaAuth

**Repository Path**: deshuofa/supaAuth

## Basic Information

- **Project Name**: supaAuth
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-28
- **Last Updated**: 2025-10-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ⚡ Supabase + Nuxt 4 Authentication Starter

> A modern and secure authentication boilerplate built with the latest versions of **Nuxt 4** and **Supabase**. Provides out-of-the-box support for user registration and login functionality, ideal for rapidly initializing new full-stack projects.

## 🆕 Changelog

- Migrated to **Nuxt 4** using the new `nuxt` package
- Integrated **latest Supabase JavaScript client** (`@supabase/supabase-js`)
- Switched to **pnpm** as the preferred package manager for faster, disk-efficient installs

## 🚀 Live Demonstrations

| Deployment Platform | Live URL                                                                 |
| ------------------- | ------------------------------------------------------------------------ |
| Vercel              | [https://supaauth-nuxt4.vercel.app/](https://supaauth-nuxt4.vercel.app/) |
| NuxtHub             | [https://supaauth.nuxt.dev/](https://supaauth.nuxt.dev/)                 |

## 🖼️ UI Preview

<div align="center">
  <img src="https://user-images.githubusercontent.com/79358543/229441570-3ba48ca8-8cf3-4fd4-aac7-2cc5eac67a03.png" width="80%" />
  <br/><br/>
  <img src="https://user-images.githubusercontent.com/79358543/229441594-e7cbec31-726d-4029-96ba-d7631fd3aef5.gif" width="60%" />
</div>

## ✅ Key Features

- 🔐 Email/password-based authentication powered by **Supabase Auth**
- 💡 Seamless integration with **Nuxt 4 Composition API**
- 🧱 Minimal and modular architecture, ideal for customization and scaling
- 📱 Fully responsive design for both mobile and desktop
- 🧼 Clean, maintainable codebase with best practices in mind

## ⚙️ Project Setup

Ensure you have [Node.js](https://nodejs.org/) and [pnpm](https://pnpm.io) installed.

```bash
# Install dependencies
pnpm install

# Start the development server
pnpm dev
```

## 🔧 Supabase Configuration

1. Create a project via [supabase.com](https://supabase.com).
2. Go to **Project Settings → API** and retrieve your `SUPABASE_URL` and `SUPABASE_ANON_KEY`.
3. Create a `.env` file in your project root:

```env
SUPABASE_URL=https://your-project-id.supabase.co
SUPABASE_ANON_KEY=your-anon-key
```

## 📚 Documentation

- [Nuxt 4 Documentation](https://nuxt.com/docs)
- [Supabase Auth Documentation](https://supabase.com/docs/guides/auth)
- [Supabase Client Reference](https://supabase.com/docs/reference/javascript/introduction)

---

## 🧑‍💻 Author

**Sefa Bulak**
📫 Contact: [zckhtln@icloud.com](mailto:zckhtln@icloud.com)
🐙 GitHub: [github.com/zackhatlen](https://github.com/zackhatlen)
🐦 Twitter: [@ZHatlen](https://twitter.com/ZHatlen)

---

## 📝 License

This project is released under the [MIT License](LICENSE).