HeyProData - Professional Networking Platform

HeyProData is a comprehensive crew-side ecosystem designed to connect professionals in film, media, and events across the MENA region. Built with a modern Next.js 15 architecture, it provides a trusted space for creatives to showcase their portfolios, discover gigs, collaborate on projects, and interact directly with decision-makers. The platform features robust role-based profiles, a dynamic jobs hub, social feeds, and real-time connectivity.

Full-StackNext.js 15TypeScriptSupabaseTailwind CSSPostgreSQL

HeyProData - Professional Networking Platform

Version: 2.7
Last Updated: January 2025
Tech Stack: Next.js 15 (App Router) + TypeScript + Supabase + Tailwind CSS

🎯 Project Overview

HeyProData is a professional networking and marketplace platform designed specifically for the film, media, and creative industries. It connects artists, producers, filmmakers, actors, crew members, and production professionals for collaboration and hiring opportunities.

Core Functionality

Professional Profiles: Showcase portfolios, skills, credits, and availability
Gigs & Jobs Marketplace: Post and apply for production opportunities
Collab Platform: Collaborative project creation and team formation
Slate Social Feed: Industry-focused social media features
What's On Events: Industry events with RSVP management
Explore/Crew Directory: Search and filter professionals by role, location, and skills
Real-time Notifications: Track applications, interests, and interactions

🛠 Tech Stack

Frontend

Framework: Next.js 15.5.4 (App Router with Turbopack)
Language: TypeScript 5
UI Library: React 19.2.0
Styling: Tailwind CSS 4 + PostCSS
UI Components: Radix UI primitives (Accordion, Dialog, Dropdown, Select, etc.)
Icons: Lucide React, Tabler Icons
State Management: React Context API (AuthContext)
HTTP Client: Axios 1.12.2
Date Handling: date-fns 4.1.0
Drag & Drop: @dnd-kit/core
Forms: React Day Picker
Notifications: Sonner (toast notifications)

Backend

API: Next.js API Routes (App Router)
Authentication: Supabase Auth with JWT tokens
Database: Supabase (PostgreSQL)
Storage: Supabase Storage (file uploads)
Validation: Custom server-side validation
Middleware: Next.js middleware for route protection

Development Tools

Linting: ESLint 9 with Next.js config
Package Manager: Yarn (lockfile present)
Build Tool: Next.js with Turbopack

🏗 Project Architecture

Application Structure


 
 
 
terminal
HeyProData/
├── /app/                    # Next.js App Router directory
│   ├── (app)/              # Authenticated app routes (with layout)
│   ├── (auth)/             # Authentication routes (login, signup, etc.)
│   ├── layout.tsx          # Root layout
│   └── globals.css         # Global styles
│
├── /api/                   # API routes (73 endpoints)
│   ├── /health/           # Health check
│   ├── /profile/          # User profile management (10 endpoints)
│   ├── /skills/           # Skills management
│   ├── /availability/     # Availability calendar
│   ├── /gigs/             # Gigs marketplace
│   ├── /collab/           # Collaboration platform
│   ├── /slate/            # Social media feed
│   ├── /whatson/          # Events management
│   ├── /explore/          # Crew directory
│   ├── /projects/         # Design projects
│   ├── /notifications/    # Notifications
│   ├── /upload/           # File uploads (6 types)
│   └── ...                # Other modules
│
├── /components/            # Reusable React components
│   ├── /ui/               # Shadcn UI components (28 components)
│   ├── /header/           # Header component
│   ├── /modules/          # Feature-specific modules
│   ├── /profile/          # Profile components
│   └── /jobs/             # Job-related components
│
├── /lib/                   # Utility libraries
│   ├── /supabase/         # Supabase client & server utilities
│   ├── apiCalling.ts      # API helper functions
│   ├── axios.ts           # Axios configuration
│   └── utils.ts           # General utilities
│
├── /contexts/              # React Context providers
│   └── AuthContext.tsx    # Authentication context
│
├── /types/                 # TypeScript type definitions
│   └── index.ts           # Shared types
│
├── /data/                  # Mock/sample data
│   ├── collabPosts.ts
│   ├── exploreProfiles.ts
│   ├── gigs.ts
│   └── ...
│
├── /documentation/         # Technical documentation
│   ├── /API-Docs/         # API documentation
│   └── /backend-documentation-and-commands/  # Module-specific docs
│
├── /public/                # Static assets
│   ├── /assets/           # Images and media
│   └── /logo/             # Branding assets
│
├── middleware.ts           # Authentication & routing middleware
├── next.config.ts          # Next.js configuration
├── tailwind.config.js      # Tailwind CSS configuration
└── package.json            # Dependencies

📁 File Structure

Root Level Files

File	Purpose
terminal `middleware.ts`	Route protection, authentication checks, session management
terminal `next.config.ts`	Next.js configuration (Turbopack, images, etc.)
terminal `tailwind.config.js`	Tailwind CSS theme and plugin configuration
terminal `tsconfig.json`	TypeScript compiler configuration
terminal `eslint.config.mjs`	ESLint rules configuration
terminal `postcss.config.mjs`	PostCSS configuration for Tailwind
terminal `components.json`	Shadcn UI component configuration
terminal `package.json`	Project dependencies and scripts
terminal `.env.sample`	Environment variables template

Key Directories

terminal
`/app/`
- Frontend Pages


 
 
 
terminal
/app/
├── (app)/                          # Protected routes (requires auth)
│   ├── page.tsx                    # Home/Explore page
│   ├── create/page.tsx             # Create content page
│   │
│   ├── (explore)/                  # Crew directory
│   │   └── explore/
│   │       ├── page.tsx            # Explore listing
│   │       └── [slug]/page.tsx    # User profile view
│   │
│   ├── (gigs)/                     # Gigs marketplace
│   │   └── gigs/
│   │       ├── page.tsx            # Gigs listing
│   │       ├── [slug]/page.tsx    # Gig details
│   │       └── manage-gigs/       # Gig management
│   │
│   ├── (collab)/                   # Collaboration platform
│   │   └── collab/
│   │       ├── page.tsx            # Collab feed
│   │       └── manage-collab/     # Collab management
│   │
│   ├── (slate-group)/              # Social feed
│   │   └── slate/page.tsx         # Slate feed
│   │
│   ├── (whatson)/                  # Events platform
│   │   └── whats-on/
│   │       ├── page.tsx            # Events listing
│   │       ├── [slug]/page.tsx    # Event details
│   │       └── manage-whats-on/   # Event management
│   │
│   ├── jobs/                       # Jobs hub
│   │   ├── page.tsx               # Jobs listing
│   │   └── (jobs)/
│   │       ├── gig/[id]/          # Gig job details
│   │       └── project/[id]/      # Project job details
│   │
│   └── profile/                    # User profile
│       └── page.tsx               # Profile page with 20+ components
│
└── (auth)/                         # Public auth routes
    ├── login/page.tsx             # Login page
    ├── signup/page.tsx            # Registration page
    ├── otp/page.tsx               # OTP verification
    ├── callback/page.tsx          # OAuth callback
    ├── forget-password/page.tsx   # Password reset request
    ├── reset-password/page.tsx    # Password reset form
    └── form/page.tsx              # Additional form page

terminal
`/components/`
- React Components


 
 
 
terminal
/components/
├── /ui/                            # Shadcn UI components (28 components)
│   ├── button.tsx                 # Button component
│   ├── dialog.tsx                 # Modal/Dialog
│   ├── dropdown-menu.tsx          # Dropdown menus
│   ├── input.tsx                  # Form inputs
│   ├── select.tsx                 # Select dropdown
│   ├── calendar.tsx               # Date picker
│   ├── card.tsx                   # Card container
│   ├── avatar.tsx                 # User avatar
│   ├── badge.tsx                  # Badge/tag component
│   ├── checkbox.tsx               # Checkbox input
│   ├── accordion.tsx              # Accordion/collapse
│   ├── navigation-menu.tsx        # Navigation component
│   ├── scroll-area.tsx            # Scrollable container
│   ├── separator.tsx              # Divider line
│   ├── skeleton.tsx               # Loading skeleton
│   ├── sonner.tsx                 # Toast notifications
│   └── ...                        # 13 more UI components
│
├── /header/                        # Header components
│   └── index.tsx                  # Main header
│
├── /modules/                       # Feature modules
│   ├── /common/
│   │   └── projectCard.tsx        # Project card component
│   └── /pages/
│       └── explore-page.tsx       # Explore page module
│
├── /profile/                       # Profile-specific components
│   ├── Card.tsx                   # Profile card
│   └── personalDetails.tsx        # Personal details section
│
├── /jobs/                          # Job-related components
│   └── JobList.tsx                # Job listing component
│
├── /Providers/                     # Context providers
│   └── index.tsx                  # Provider wrapper
│
├── icons.tsx                       # Icon components
└── logo.tsx                        # Logo component

terminal
`/lib/`
- Utility Libraries


 
 
 
terminal
/lib/
├── /supabase/
│   ├── client.ts                  # Browser-side Supabase client
│   └── server.ts                  # Server-side Supabase client + helpers
│       ├── createServerClient()   # Create server client
│       ├── validateAuthToken()    # Token validation
│       ├── getUserFromRequest()   # Extract user from request
│       ├── successResponse()      # Standard success response
│       ├── errorResponse()        # Standard error response
│       └── hasCompleteProfile()   # Profile completeness check
│
├── apiCalling.ts                   # API helper functions
├── axios.ts                        # Axios instance configuration
├── countries.ts                    # Country data (18KB)
└── utils.ts                        # General utility functions

🔌 API Structure

API Statistics

Total Endpoints: 73 routes
Total Modules: 15
Authentication Required: 60+ endpoints
Public Endpoints: 10+ endpoints

API Modules Overview

1. Health Check (1 endpoint)


 
 
 
terminal
GET /api/health                    # API health check

2. Profile Management (10 endpoints)


 
 
 
terminal
GET    /api/profile                # Get user profile
PATCH  /api/profile                # Update user profile
GET    /api/profile/check          # Check profile completion
GET    /api/profile/links          # Get social media links
POST   /api/profile/links          # Add social link
PATCH  /api/profile/links          # Update social link
DELETE /api/profile/links          # Delete social link
GET    /api/profile/roles          # Get professional roles
POST   /api/profile/roles          # Add role
DELETE /api/profile/roles          # Delete role
GET    /api/profile/languages      # Get languages
POST   /api/profile/languages      # Add language
PATCH  /api/profile/languages      # Update language
DELETE /api/profile/languages      # Delete language
GET    /api/profile/visa           # Get visa information
POST   /api/profile/visa           # Add visa info
PATCH  /api/profile/visa           # Update visa info
GET    /api/profile/travel-countries  # Get travel countries
POST   /api/profile/travel-countries  # Add travel country
DELETE /api/profile/travel-countries  # Delete travel country
GET    /api/profile/credits        # Get work history
POST   /api/profile/credits        # Add credit
PATCH  /api/profile/credits        # Update credit
DELETE /api/profile/credits        # Delete credit
GET    /api/profile/highlights     # Get profile highlights
POST   /api/profile/highlights     # Add highlight
PATCH  /api/profile/highlights     # Update highlight
DELETE /api/profile/highlights     # Delete highlight
GET    /api/profile/recommendations  # Get recommendations
POST   /api/profile/recommendations  # Add recommendation
DELETE /api/profile/recommendations  # Delete recommendation

3. Skills Management (3 endpoints)


 
 
 
terminal
GET    /api/skills                 # Get user skills
POST   /api/skills                 # Add skill
PATCH  /api/skills/[id]            # Update skill
DELETE /api/skills/[id]            # Delete skill

4. Availability Management (4 endpoints)


 
 
 
terminal
GET    /api/availability           # Get availability calendar
POST   /api/availability           # Set availability
GET    /api/availability/check     # Check availability conflicts
PATCH  /api/availability/[id]      # Update availability status

5. Notifications (3 endpoints)


 
 
 
terminal
GET    /api/notifications          # Get user notifications
PATCH  /api/notifications/[id]/read  # Mark as read
PATCH  /api/notifications/mark-all-read  # Mark all as read

6. Contacts Management (3 endpoints)


 
 
 
terminal
POST   /api/contacts               # Add contact to gig
GET    /api/contacts/gig/[gigId]   # Get gig contacts
DELETE /api/contacts/[id]          # Delete contact

7. Referrals (2 endpoints)


 
 
 
terminal
GET    /api/referrals              # Get referrals
POST   /api/referrals              # Create referral

8. File Uploads (6 endpoints)


 
 
 
terminal
POST   /api/upload/resume          # Upload resume (5MB, PDF/DOC/DOCX)
POST   /api/upload/portfolio       # Upload portfolio (10MB, PDF/Images/Videos)
POST   /api/upload/profile-photo   # Upload profile photo (2MB, JPEG/PNG/WebP)
POST   /api/upload/collab-cover    # Upload collab cover (5MB, JPEG/PNG)
POST   /api/upload/slate-media     # Upload slate media (10MB, Images/Videos)
POST   /api/upload/project-asset   # Upload project asset (20MB, Multiple types)

9. Gigs & Jobs Marketplace (6 endpoints)


 
 
 
terminal
GET    /api/gigs                   # List gigs (with filters)
POST   /api/gigs                   # Create gig
GET    /api/gigs/[id]              # Get gig details
PATCH  /api/gigs/[id]              # Update gig
DELETE /api/gigs/[id]              # Delete gig
GET    /api/gigs/slug/[slug]       # Get gig by slug
POST   /api/gigs/[id]/apply        # Apply to gig
GET    /api/gigs/[id]/applications  # Get gig applications (creator only)
PATCH  /api/gigs/[id]/applications/[applicationId]/status  # Update application status

10. Applications (2 endpoints)


 
 
 
terminal
GET    /api/applications/my        # Get user's applications
GET    /api/applications/[id]      # Get application details

11. Explore/Crew Directory (3 endpoints)


 
 
 
terminal
GET    /api/explore                # Search and filter crew profiles
GET    /api/explore/categories     # Get role categories with counts
GET    /api/explore/[userId]       # Get detailed user profile

12. Collab Platform (8 endpoints)


 
 
 
terminal
GET    /api/collab                 # List collab posts (with filters)
POST   /api/collab                 # Create collab post
GET    /api/collab/my              # Get user's collab posts
GET    /api/collab/[id]            # Get collab post details
PATCH  /api/collab/[id]            # Update collab post
DELETE /api/collab/[id]            # Delete collab post
POST   /api/collab/[id]/interest   # Express interest
DELETE /api/collab/[id]/interest   # Remove interest
GET    /api/collab/[id]/interests  # List interested users (owner only)
GET    /api/collab/[id]/collaborators  # List collaborators
POST   /api/collab/[id]/collaborators  # Add collaborator
DELETE /api/collab/[id]/collaborators/[userId]  # Remove collaborator
PATCH  /api/collab/[id]/close      # Close collab post

13. Slate Social Media (10 endpoints)


 
 
 
terminal
GET    /api/slate                  # Get feed (with pagination)
POST   /api/slate                  # Create post
GET    /api/slate/my               # Get user's posts
GET    /api/slate/saved            # Get saved posts
GET    /api/slate/[id]             # Get post details
PATCH  /api/slate/[id]             # Update post
DELETE /api/slate/[id]             # Delete post
POST   /api/slate/[id]/like        # Like post
DELETE /api/slate/[id]/like        # Unlike post
GET    /api/slate/[id]/likes       # Get users who liked
GET    /api/slate/[id]/comment     # Get comments
POST   /api/slate/[id]/comment     # Add comment
POST   /api/slate/[id]/share       # Share post
DELETE /api/slate/[id]/share       # Unshare post
POST   /api/slate/[id]/save        # Save post
DELETE /api/slate/[id]/save        # Unsave post
PATCH  /api/slate/comment/[commentId]  # Edit comment
DELETE /api/slate/comment/[commentId]  # Delete comment

14. What's On Events (7 endpoints)


 
 
 
terminal
GET    /api/whatson                # List events (with filters)
POST   /api/whatson                # Create event
GET    /api/whatson/my             # Get user's events
GET    /api/whatson/rsvps/my       # Get user's RSVPs
GET    /api/whatson/[id]           # Get event details
PATCH  /api/whatson/[id]           # Update event
DELETE /api/whatson/[id]           # Delete event
POST   /api/whatson/[id]/rsvp      # Create RSVP
DELETE /api/whatson/[id]/rsvp      # Cancel RSVP
GET    /api/whatson/[id]/rsvp/list  # Get event RSVPs (creator only)
GET    /api/whatson/[id]/rsvp/export  # Export RSVPs as CSV (creator only)

15. Design Projects (9 endpoints)


 
 
 
terminal
GET    /api/projects               # List projects
POST   /api/projects               # Create project
GET    /api/projects/my            # Get user's projects
GET    /api/projects/[id]          # Get project details
PATCH  /api/projects/[id]          # Update project
DELETE /api/projects/[id]          # Delete project
GET    /api/projects/[id]/team     # List team members
POST   /api/projects/[id]/team     # Add team member
PATCH  /api/projects/[id]/team/[userId]  # Update team member role
DELETE /api/projects/[id]/team/[userId]  # Remove team member
GET    /api/projects/[id]/files    # Get project files
DELETE /api/projects/[id]/files/[fileId]  # Delete file
GET    /api/projects/[id]/links    # List project links
POST   /api/projects/[id]/links    # Add project link
DELETE /api/projects/[id]/links/[linkId]  # Delete link

🔐 Authentication

Authentication System

Provider: Supabase Auth
Method: JWT Bearer Tokens
Storage: HTTP-only cookies (via Supabase SSR)
Validation: Server-side token validation on protected routes

Authentication Flow

1. Login/Registration


 
 
 
terminal
User → Login Page → Supabase Auth → JWT Token → Cookie Storage

2. Token Validation (API Routes)


 
 
 
typescript
// Pattern used in all protected API routes
const authHeader = request.headers.get('Authorization');
const user = await validateAuthToken(authHeader);

if (!user) {
  return NextResponse.json(
    errorResponse('Authentication required'),
    { status: 401 }
  );
}

3. Middleware Protection


 
 
 
typescript
// middleware.ts protects routes
const protectedRoutes = [
  '/home', '/profile', '/explore', '/gigs', 
  '/collab', '/whatson', '/notifications'
];

// Redirects to /login if not authenticated

Protected vs Public Routes

Protected Routes (Require Authentication)

terminal
/home
- Home page
terminal
/profile
- User profile
terminal
/explore
- Crew directory
terminal
/gigs
- Gigs marketplace
terminal
/collab
- Collaboration platform
terminal
/slate
- Social feed
terminal
/whatson
- Events
terminal
/jobs
- Jobs hub
All

terminal
/api/*
routes (except health check)

Public Routes (No Authentication Required)

terminal
/login
- Login page
terminal
/signup
- Registration page
terminal
/otp
- OTP verification
terminal
/callback
- OAuth callback
terminal
/forget-password
- Password reset
terminal
/reset-password
- Reset form
terminal
/api/health
- Health check

Session Management

Token Refresh: Handled automatically by Supabase SSR
Session Expiry: Configurable in Supabase
Logout: Clears cookies and redirects to login

🗄 Database

Database System

Provider: Supabase (PostgreSQL)
ORM: Supabase Client (query builder)
Row Level Security (RLS): Enabled for user data protection

Key Tables (Based on API Routes)

User & Profile

terminal
user_profiles
- User profile information
terminal
user_roles
- Professional roles
terminal
user_languages
- Language proficiency
terminal
user_skills
- Skills and expertise
terminal
user_links
- Social media links
terminal
user_visa
- Visa information
terminal
user_travel_countries
- Travel availability
terminal
user_credits
- Work history/credits
terminal
user_highlights
- Profile highlights
terminal
user_recommendations
- Recommendations

Availability

terminal
availability
- User availability calendar
terminal
availability_conflicts
- Conflict detection

Gigs & Applications

terminal
gigs
- Job postings
terminal
gig_applications
- Applications to gigs
terminal
gig_contacts
- Contact information

Collaboration

terminal
collab_posts
- Collaboration posts
terminal
collab_interests
- Interest expressions
terminal
collab_collaborators
- Confirmed collaborators

Social (Slate)

terminal
slate_posts
- Social media posts
terminal
slate_likes
- Post likes
terminal
slate_comments
- Post comments
terminal
slate_shares
- Post shares
terminal
slate_saved
- Saved posts

Events (What's On)

terminal
whatson_events
- Events
terminal
whatson_rsvps
- Event RSVPs

Projects

terminal
projects
- Design projects
terminal
project_team
- Team members
terminal
project_files
- Project files
terminal
project_links
- External links

System

terminal
notifications
- User notifications
terminal
referrals
- Referral tracking

Storage Buckets


 
 
 
terminal
Supabase Storage:
├── resumes/              # Resume uploads (5MB limit)
├── portfolios/           # Portfolio files (10MB limit)
├── profile-photos/       # Profile photos (2MB limit)
├── collab-covers/        # Collab post covers (5MB limit)
├── slate-media/          # Slate post media (10MB limit)
└── project-assets/       # Project files (20MB limit)

🚀 Installation & Setup

Prerequisites

Node.js 18+ (for Next.js 15)
Yarn package manager
Supabase account and project

Environment Variables

Create a

terminal

.env.local

file in the root directory:


 
 
 
env
# Supabase Configuration
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

# Optional: Other configurations
NEXT_PUBLIC_APP_URL=http://localhost:3000

Installation Steps

Clone the repository


 
 
 
bash
git clone <repository-url>
cd HeyProData

Install dependencies
```
 
 
 
bash
yarn install
```

Set up environment variables


 
 
 
bash
cp .env.sample .env.local
# Edit .env.local with your Supabase credentials

Set up database schema


 
 
 
bash
# Run the SQL schema in your Supabase SQL Editor
# File: /app/supabase_schema.sql
# Or follow instructions in SETUP_INSTRUCTIONS.md

Start development server
```
 
 
 
bash
yarn dev
```

Access the application


 
 
 
terminal
Frontend: http://localhost:3000
API Health: http://localhost:3000/api/health

💻 Development Commands

Available Scripts


 
 
 
bash
# Development
yarn dev              # Start development server with Turbopack

# Production
yarn build            # Build for production with Turbopack
yarn start            # Start production server

# Code Quality
yarn lint             # Run ESLint

Development Workflow

Hot Reload: Enabled by default in development mode
Turbopack: Used for faster builds and HMR
TypeScript: Strict mode enabled for type safety
API Development:
- API routes auto-reload on save
- Test with
  
  terminal
  http://localhost:3000/api/<endpoint>
Component Development:
- Components hot-reload instantly
- Styled with Tailwind CSS utilities

✨ Key Features

Profile Management

Comprehensive Profiles:
- Personal details (name, location, bio)
- Professional roles and positions
- Skills with experience levels and rates
- Work credits and production history
- Profile highlights and recommendations
- Social media links
- Language proficiency
- Visa and travel information
Availability Calendar: Set and manage availability dates
Profile Completion Tracker: Visual progress indicator
Portfolio Uploads: Showcase work with file uploads

Marketplace Features

Gigs Marketplace:
- Create and manage job postings
- Apply to gigs with custom applications
- Track application status
- Filter by role, location, budget
Application Management: Track all applications in one place

Collaboration Platform

Collab Posts:
- Create collaborative project opportunities
- Express interest in projects
- Manage collaborators and team members
- Close posts when positions are filled
Team Management: Add/remove collaborators

Feed: Browse industry-related posts
Interactions: Like, comment, share posts
Bookmarks: Save posts for later
User Content: Create and manage your own posts
Engagement Tracking: View likes and comment counts

Events (What's On)

Event Creation: Create industry events
RSVP Management: Track attendees
Event Discovery: Browse upcoming events
CSV Export: Export RSVP lists for organizers

Search & Discovery

Explore/Crew Directory:
- Search professionals by role
- Filter by location, skills, availability
- View detailed profiles
- Category-based browsing
Role Categories: Organized by department and role type

Notifications System

Real-time Notifications: Track all activities
Notification Types:
- Application updates
- Interest expressions
- Event RSVPs
- System messages
Mark as Read: Individual or bulk mark as read

📚 Documentation

Additional Documentation Files

terminal
/documentation/API-Docs/API_DOC.md
- Detailed API documentation
terminal
/documentation/API-Docs/API_ROUTES_SUMMARY.md
- Complete API routes summary
terminal
/documentation/MIGRATION_ROADMAP.md
- Migration and upgrade guides
terminal
/documentation/PHASE_1_SUMMARY.md
- Project phase summaries
terminal
/documentation/backend-documentation-and-commands/
- Module-specific docs
terminal
AUTHENTICATION_TEST_CHECKLIST.md
- Authentication testing guide
terminal
GOOGLE_AUTH_SETUP.md
- Google OAuth setup instructions

🔧 Technical Notes

API Response Format

All API endpoints follow this standard response format:

Success Response:


 
 
 
json
{
  "success": true,
  "message": "Success message",
  "data": { ... }
}

Error Response:


 
 
 
json
{
  "success": false,
  "error": "Error message",
  "details": { ... }
}

Authentication Pattern

All protected API routes use this pattern:


 
 
 
typescript
const authHeader = request.headers.get('Authorization');
const user = await validateAuthToken(authHeader);

if (!user) {
  return NextResponse.json(
    errorResponse('Authentication required'),
    { status: 401 }
  );
}

// Proceed with authenticated request

File Upload Constraints

Upload Type	Max Size	Allowed Types	Bucket
Resume	5MB	PDF, DOC, DOCX	resumes/
Portfolio	10MB	PDF, Images, Videos	portfolios/
Profile Photo	2MB	JPEG, PNG, WebP	profile-photos/
Collab Cover	5MB	JPEG, PNG	collab-covers/
Slate Media	10MB	Images, Videos	slate-media/
Project Asset	20MB	Multiple types	project-assets/

Next.js App Router Features

Server Components: Default for all components
Client Components: Used for interactive UI (

terminal
'use client'
)
Route Groups: Organized with

terminal
(app)
and

terminal
(auth)
groups
Dynamic Routes:

terminal
[slug]
,

terminal
[id]
,

terminal
[userId]
patterns
Layouts: Nested layouts for different sections
Middleware: Route protection and authentication

🏷 Version History

v2.7 (January 2025) - Current version with 73 API endpoints
v2.6 - Added Design Projects module
v2.5 - Implemented What's On events platform
v2.0 - Major architecture update with Supabase
v1.0 - Initial release

📄 License

[Your License Here]

👥 Contributors

[Your Team/Contributors Here]

Last Updated: January 2025
Maintained By: HeyProData Team

Project Links

Live Demo View Source

Highlights

Specialized profile system for showcasing industry roles, skills, and rich portfolios
Integrated Gigs marketplace and Jobs hub tailored for crew recruitment
Secure authentication and session management utilizing Supabase Auth
Real-time notifications, event management, and dynamic social feeds
Strict Row Level Security (RLS) ensuring protected user data and secure API routing

Key Challenge

Architecting a highly relational database system with Supabase while enforcing secure server-side rendering (SSR) authentication and managing complex user roles across a multi-faceted platform.

HeyProData - Professional Networking Platform

HeyProData - Professional Networking Platform

📋 Table of Contents

🎯 Project Overview

Core Functionality

🛠 Tech Stack

Frontend

Backend

Development Tools

🏗 Project Architecture

Application Structure

📁 File Structure

Root Level Files

Key Directories

terminalCopy/app/ - Frontend Pages

terminalCopy/components/ - React Components

terminalCopy/lib/ - Utility Libraries

🔌 API Structure

API Statistics

API Modules Overview

1. Health Check (1 endpoint)

2. Profile Management (10 endpoints)

3. Skills Management (3 endpoints)

4. Availability Management (4 endpoints)

5. Notifications (3 endpoints)

6. Contacts Management (3 endpoints)

7. Referrals (2 endpoints)

8. File Uploads (6 endpoints)

9. Gigs & Jobs Marketplace (6 endpoints)

10. Applications (2 endpoints)

11. Explore/Crew Directory (3 endpoints)

12. Collab Platform (8 endpoints)

13. Slate Social Media (10 endpoints)

14. What's On Events (7 endpoints)

15. Design Projects (9 endpoints)

🔐 Authentication

Authentication System

Authentication Flow

1. Login/Registration

2. Token Validation (API Routes)

3. Middleware Protection

Protected vs Public Routes

Protected Routes (Require Authentication)

Public Routes (No Authentication Required)

Session Management

🗄 Database

Database System

Key Tables (Based on API Routes)

User & Profile

Availability

Gigs & Applications

Collaboration

Social (Slate)

Events (What's On)

Projects

System

Storage Buckets

🚀 Installation & Setup

Prerequisites

Environment Variables

Installation Steps

💻 Development Commands

Available Scripts

Development Workflow

✨ Key Features

Profile Management

Marketplace Features

Collaboration Platform

Social Features (Slate)

Events (What's On)

Search & Discovery

Notifications System

📚 Documentation

Additional Documentation Files

🔧 Technical Notes

API Response Format

Authentication Pattern

File Upload Constraints

Next.js App Router Features

🏷 Version History

terminal
`/app/`
- Frontend Pages

terminal
`/components/`
- React Components

terminal
`/lib/`
- Utility Libraries