This project handles all the frontend logic by defining API endpoints, which communicate with the my backend project to perform operations like user registration, login, reset-password and account management. It is built using Next.js. These act as middleware, validating and forwarding requests to the FastAPI backend.

🧾 Auth Features

🔐 User Registration ( And Otp Verification)

Signup page

Using Email

POST /api/auth/start-registration This feature allows users to register by providing their email address. An OTP (One-Time Password) is sent to the user's email for verification.

OTP Verification

POST /api/auth/verify-email After OTP verification, POST /api/auth/set-session this automatically signs the user in. This feature I like very much and remember building for days to make it work perfectly.

Using Google and Github

Just Simple implementation of Google POST /api/auth/google and Github POST /api/auth/github OAuth login. backend handles the OAuth flow and returns user data to the frontend.

Google Login

🔓 Login

Using Email/Username and Password

Log in using their email/username and password. After successful authentication, user is redirected to dashboard page.

Using Google and Github

The backend handles the OAuth flow in this case as well.

🔁 Reset Password ( Request + Confirm )

POST /api/auth/request-password-reset and POST /api/auth/verify-password-reset Reset password by requesting a password reset OTP via email/username.

Request Password Reset

Reset Password

POST /api/auth/reset-password After OTP verification, users can set a new password.

Reset Password

🔑 Session and Account Management

GET /api/user/me - Retrieve the current user's profile information. POST /api/user/me - Update the current user's profile information.

Dashboard Page

POST /api/auth/refresh The session is automatically refreshed when the user interacts with the application.

🚪 Logout

POST /api/auth/logout - Logs the user out and clears the session.

📂 Folder Structure

src/
├── app/                     # Next.js App Router
│   ├── api/                 # API routes
│   │   ├── auth/            # Auth API endpoints
│   │   └── user/            # User API endpoints
│   │       └── me/          # User profile operations
│   ├── auth/                # Auth pages
│   │   ├── user/            # User auth flows
│   │   └── admin/           # Admin auth flows
│   └── user/                # User dashboard pages
│       ├── dashboard/       # Main user dashboard
│       └── me/              # Profile management
├── components/              # Shared components
│   └── ui/                  # UI component library
├── lib/                     # Utility libraries
├── middleware               # Next.js request middleware
└── utils/                   # Additional utilities