# SaifURL Frontend

A modern, fullstack URL shortener **frontend** built with React, featuring user authentication, dashboard, custom domains, and more.

---

## Features

- 🔗 **Shorten URLs** with custom aliases and multiple domains
- 👤 **User authentication** (sign up, sign in, password reset)
- 🏠 **Dashboard** to manage your short URLs
- 📊 **Click tracking** for each short URL
- 🎨 **Light/Dark theme** support
- 🛡️ **Email verification** for secure accounts
- 🛠️ **Profile management** (update info, change password)
- 🌐 **HashRouter** for static hosting compatibility

---

## Getting Started

### 1. **Clone the repository**

```sh
git clone https://github.com/saif-abdelrazek/saifurl.git
cd saifurl
```

### 2. **Install dependencies**

```sh
npm install
```

### 3. **Set environment variables**

Create a `.env` file if you want to override the default API URL:

```
VITE_API_URL=https://api.saifabdelrazek.com/v1
```

### 4. **Run the app**

```sh
npm run dev
```

The app will be available at [http://localhost:5173](http://localhost:5173) (or your Vite dev port).

---

## Project Structure

```
src/
  components/         # Reusable UI components
  contexts/           # React context providers (Dashboard, Shorturls)
  pages/              # Main pages (Dashboard, Profile, Auth, etc.)
  routers/            # Main router and route utilities
  App.jsx             # App entry point
  main.jsx            # ReactDOM entry
```

---

## Usage

- **Sign up** and verify your email.
- **Sign in** to access your dashboard.
- **Create, edit, and delete** short URLs.
- **Copy** short URLs with one click.
- **Switch themes** using the toggle in the header or profile.
- **Manage your profile** and change your password.
- **Reset your password** via the "Forget Password" page.

---

## API

This frontend connects to the [SaifAPI](https://github.com/saif-abdelrazek/saifapi) backend service.

- **API repository:** [https://github.com/saif-abdelrazek/saifapi](https://github.com/saif-abdelrazek/saifapi)
- **Default API URL:** `https://api.saifabdelrazek.com/v1`

---

## Deployment

- The app uses **HashRouter** for static hosting (e.g., Netlify, Vercel, GitHub Pages).
- Make sure your backend API is accessible at the URL set in `VITE_API_URL`.

---

## Credits

- Built by [Saif Abdelrazek](https://saifabdelrazek.com)
- API backend: [saif-abdelrazek/saifapi](https://github.com/saif-abdelrazek/saifapi)

---