🚀 TeamUp-AI

An intelligent platform to discover and form high-performing teams based on skills, interests, and network compatibility.

📖 Overview

TeamUp-AI is a modern web application designed to help developers, designers, and creators find and connect with their ideal team members. Unlike traditional job boards or directories, TeamUp uses an intelligent matching algorithm that considers:

🎯 Skills & Expertise - Find people with the technical skills you need
💡 Shared Interests - Discover team members who share your vision and passion
🔗 Network Intelligence - Leverage mutual connections and shared organizations
✨ Chemistry Detection - AI-powered algorithm to ensure team compatibility

✨ Key Features

🎯 Intelligent Skill + Interest Matching

Advanced matching algorithm that weighs shared interests heavily
Discover collaborators who align with your project vision
Get personalized recommendations based on your profile

🌐 Network-Aware Discovery

Mutual connections boost match quality
Build trust through shared organizations
See how you're connected to potential teammates

💬 Real-time Collaboration

Instant messaging with potential teammates
Form groups and discuss project ideas
Finalize your team roster without leaving the platform
Emoji reactions and rich message support

👥 Profile Showcase

Display your top skills and expertise
Share your interests and passion projects
Show match scores with potential collaborators
Follow and connect with other builders

📊 Discover & Recommendations

Interest-based profile recommendations
Top profiles in your network
Advanced search and filtering
Beautiful profile cards with detailed stats

🛠 Tech Stack

Frontend

Next.js 15.5 - React framework with App Router
TypeScript - Type-safe JavaScript
Tailwind CSS - Utility-first styling
Framer Motion - Smooth animations and transitions
Radix UI - Accessible component primitives

Backend & Database

Supabase - PostgreSQL database, authentication & real-time
Next.js API Routes - Serverless backend functions
Upstash - Rate limiting and Redis caching

Deployment & Analytics

Vercel - Hosting and edge functions
Vercel Analytics - Performance monitoring
Vercel Speed Insights - Real User Monitoring (RUM)
PostHog - Product analytics

Quality & Testing

Playwright - End-to-end testing framework
OXLint - Fast, zero-config JavaScript linter
TypeScript Compiler - Static type checking

🚀 Quick Start

Prerequisites

Node.js 18+ (recommend 20+)
npm, yarn, pnpm, or bun
Supabase project (free tier available)

Installation

Clone the repository

git clone https://github.com/Shaurya-dev7/TeamUP-AI.git
cd TeamUP-AI

Install dependencies

npm install
# or
pnpm install
# or
yarn install
# or
bun install

Set up environment variables

Copy .env.local.example to .env.local and fill in your Supabase credentials:

cp .env.local.example .env.local

NEXT_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your-public-anon-key
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key

Set up the database

Create a profiles table in Supabase matching the schema in database.types.ts. Then seed demo data:

node scripts/seed_profiles.js

⚠️ Security Note: The SUPABASE_SERVICE_ROLE_KEY is sensitive. Never commit it or expose it in public code.

Start the development server

npm run dev
# or
pnpm dev
# or
yarn dev
# or
bun dev

Open http://localhost:3000 to see the app.

📱 Available Scripts

# Development
npm run dev              # Start dev server on port 3000
npm run dev:lan         # Start dev server on all network interfaces
npm run dev:all         # Start all services

# Production
npm run build            # Build for production
npm start                # Start production server
npm run start:lan        # Start production server on all network interfaces

# Quality Assurance
npm run lint             # Run OXLint
npm run type-check       # TypeScript type checking
npm run check-all        # Run lint and type-check

# Testing
npm test                 # Run Playwright tests
npm run test -- --ui     # Run tests in UI mode (interactive)
npm run test -- --headed # Run tests with visible browser

Test Commands

# Run specific test file
npx playwright test tests/home.spec.ts

# Run tests in debug mode
npx playwright test --debug

# Generate test report
npx playwright show-report

# Run tests for specific browser
npx playwright test --project=chromium
npx playwright test --project=firefox
npx playwright test --project=webkit

📂 Project Structure

TeamUP-AI/
├── app/                    # Next.js app directory
│   ├── page.tsx           # Home page
│   ├── layout.tsx         # Root layout
│   └── api/               # API routes
├── components/            # Reusable React components
│   ├── AppFooter.tsx
│   ├── HeroCarousel.tsx
│   ├── TeamUpEarthScroll.tsx
│   └── ...
├── lib/                   # Utility functions
│   └── utils.ts          # Tailwind merge utilities
├── tests/                 # E2E tests with Playwright
│   ├── home.spec.ts
│   ├── discover.spec.ts
│   ├── profile.spec.ts
│   ├── chat.spec.ts
│   ├── auth.spec.ts
│   └── ...
├── scripts/              # Utility scripts
│   └── seed_profiles.js  # Database seeding
├── docs/                 # Documentation
│   └── standards/        # Coding standards & guidelines
├── public/               # Static assets
├── .env.local.example    # Environment variables template
├── next.config.ts        # Next.js configuration
├── tailwind.config.ts    # Tailwind CSS configuration
├── tsconfig.json         # TypeScript configuration
└── playwright.config.ts  # Playwright test configuration

🧪 Testing

The project includes comprehensive end-to-end tests covering:

Home page - Content, navigation, featured sections
Discovery - Search, recommendations, profile cards, follow/unfollow
Profiles - Display, stats, skills, interests, follow buttons
Chat - Messaging, profile search, message input
Authentication - Login, signup, form validation
Navigation - Site-wide navigation, link functionality
API Endpoints - Discover API, profile API

See tests/README.md for detailed testing documentation.

📚 Database Schema

Profiles Table

CREATE TABLE profiles (
  id UUID PRIMARY KEY,
  username TEXT UNIQUE,
  full_name TEXT,
  avatar_url TEXT,
  bio TEXT,
  skills TEXT[],
  interests TEXT[],
  followers_count INT DEFAULT 0,
  following_count INT DEFAULT 0,
  created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
  updated_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);

Refer to database.types.ts for the complete type definitions.

🌍 Deployment

Deploy on Vercel (Recommended)

The easiest way to deploy is using the Vercel Platform:

Push your code to GitHub
Import the repository on Vercel
Add your environment variables in Vercel dashboard
Deploy with one click

Environment Variables on Vercel

Go to Settings → Environment Variables
Add:
- NEXT_PUBLIC_SUPABASE_URL
- NEXT_PUBLIC_SUPABASE_ANON_KEY
- SUPABASE_SERVICE_ROLE_KEY

See Next.js deployment documentation for more options.

🎨 Design & Standards

This project follows best practices and guidelines documented in:

React Best Practices - Performance optimization, waterfalls, bundle size
Web Design Guidelines - Accessibility, UX, forms, animations

🤝 Contributing

Contributions are welcome! Here's how to get started:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

Please ensure:

Code passes linting: npm run lint
Types are correct: npm run type-check
Tests pass: npm test

📝 License

This project is open source and available under the MIT License.

🙋 Support

Have questions or need help?

📧 Email: Create an issue on GitHub
🐛 Bug Reports: GitHub Issues
💬 Discussions: GitHub Discussions

👨‍💻 Author

Shaurya Deep

GitHub: @Shaurya-dev7
Full Stack Developer | 3rd Year

🔗 Resources

⭐ Show Your Support

If you like this project, please consider:

⭐ Starring this repository
🔗 Sharing with your network
🐛 Reporting bugs or suggesting features
🤝 Contributing to the project

Built with ❤️ for builders, by builders

Name		Name	Last commit message	Last commit date
Latest commit History 53 Commits
.easycode-ai/publish		.easycode-ai/publish
.vscode		.vscode
app		app
componenets_ss		componenets_ss
components		components
docs		docs
hooks		hooks
lib		lib
pages/api		pages/api
playwright-report		playwright-report
public		public
scripts		scripts
supabase		supabase
test-results		test-results
tests		tests
.env.local.example		.env.local.example
.gitignore		.gitignore
.npmrc		.npmrc
.oxlintrc.json		.oxlintrc.json
README.md		README.md
SETUP_INSTRUCTIONS.md		SETUP_INSTRUCTIONS.md
SUPABASE_FIX.md		SUPABASE_FIX.md
TEST_USERNAMES.md		TEST_USERNAMES.md
build.log		build.log
components.json		components.json
database.types.ts		database.types.ts
instrumentation-client.ts		instrumentation-client.ts
logo_preview.html		logo_preview.html
middleware.ts		middleware.ts
modern_3d_teamup_chat.png		modern_3d_teamup_chat.png
modern_3d_teamup_chat_home_dark.png		modern_3d_teamup_chat_home_dark.png
next-env.d.ts		next-env.d.ts
next.config.mjs		next.config.mjs
package-lock.json		package-lock.json
package.json		package.json
playwright.config.cjs		playwright.config.cjs
playwright.config.ts		playwright.config.ts
postcss.config.mjs		postcss.config.mjs
schema_dump.sql		schema_dump.sql
tailwind.config.ts		tailwind.config.ts
teamup-ai-platform.tar.gz		teamup-ai-platform.tar.gz
test-audit.js		test-audit.js
test-db.js		test-db.js
test-db.log		test-db.log
test-output.log		test-output.log
test-users.js		test-users.js
test-users.log		test-users.log
tsconfig.json		tsconfig.json
tsconfig.tsbuildinfo		tsconfig.tsbuildinfo
vercel.json		vercel.json

Folders and files

Latest commit

History

Repository files navigation

🚀 TeamUp-AI

📖 Overview

✨ Key Features

🎯 Intelligent Skill + Interest Matching

🌐 Network-Aware Discovery

💬 Real-time Collaboration

👥 Profile Showcase

📊 Discover & Recommendations

🛠 Tech Stack

Frontend

Backend & Database

Deployment & Analytics

Quality & Testing

🚀 Quick Start

Prerequisites

Installation

📱 Available Scripts

Test Commands

📂 Project Structure

🧪 Testing

📚 Database Schema

Profiles Table

🌍 Deployment

Deploy on Vercel (Recommended)

Environment Variables on Vercel

🎨 Design & Standards

🤝 Contributing

📝 License

🙋 Support

👨‍💻 Author

🔗 Resources

⭐ Show Your Support

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages