Skip to content

appteam-nith/App-Team

Repository files navigation

AppTeam Frontend πŸš€

React TypeScript Tailwind CSS Vite

A modern, responsive frontend application for AppTeam NIT Hamirpur - the premier technology innovation team. Built with cutting-edge technologies and optimized for performance across all devices.

🌟 Features

🏠 Core Sections

  • Hero Section - Dynamic introduction with animated backgrounds and team statistics
  • About Us - Mission, values, and team culture showcase
  • Projects Portfolio - Interactive gallery of team projects and applications
  • Workshops - Educational content and upcoming training sessions
  • Achievements - Awards, competitions, and team milestones
  • Team Members - Dynamic member profiles with social links
  • Join Team - Team application system with multi-step forms
  • Contact - Contact form with real-time validation and toast notifications

🎨 Design & UI/UX

  • Glassmorphism Design - Modern frosted glass aesthetic
  • Animated Backgrounds - Code rain and particle effects
  • Responsive Layout - Mobile-first design approach
  • Dark Theme - Professional dark mode interface
  • Interactive Animations - Smooth transitions and hover effects
  • Custom Glassmorphism Cards - Reusable glass-effect components
  • Gradient Overlays - Beautiful color gradients and effects

πŸ“± Responsive Features

  • Mobile Optimized - Touch-friendly navigation and interactions
  • Performance Focused - Lazy loading and code splitting
  • Hardware Acceleration - GPU-optimized animations
  • Progressive Loading - Suspense boundaries for smooth UX
  • Responsive Typography - Adaptive text sizing
  • Touch Gestures - Mobile-specific interactions

πŸ”§ Admin Panel

  • Member Management - Add, edit, delete, and manage team member profiles
  • Announcement System - Create and manage announcements with different priorities
  • Team Applications - Review and manage team membership applications
  • Content Management - Easy content updates through admin interface
  • Status Management - Toggle visibility and status of various elements
  • Export Functionality - Export team applications to Excel format

πŸš€ Team Application System

  • Multi-Step Form - Progressive form with validation
  • Technical Skills Selection - Comprehensive skill and framework options
  • File Upload Support - Portfolio and resume attachments
  • Real-time Validation - Instant feedback and error handling
  • Application Tracking - Status monitoring for applicants
  • Automated Email Notifications - Status updates via email

πŸ“ž Contact & Communication

  • Contact Form - Multi-field contact form with validation
  • Real-time Notifications - Toast messages for user feedback
  • Social Media Integration - Links to official team social profiles
  • Location Integration - Interactive location information
  • Email Integration - Direct email functionality

🎯 Interactive Elements

  • Smooth Scrolling - Seamless section navigation
  • Interactive Stats - Dynamic counters and statistics
  • Hover Effects - Rich micro-interactions
  • Loading States - Professional loading animations
  • Error Boundaries - Graceful error handling
  • 404 Page - Custom not-found page

πŸ› οΈ Tech Stack

Frontend Framework

  • React 18.3.1 - Modern React with hooks and concurrent features
  • TypeScript 5.5.3 - Type-safe development
  • React Router DOM 7.6.2 - Client-side routing

Styling & Design

  • Tailwind CSS 3.4.1 - Utility-first CSS framework
  • Custom CSS - Glassmorphism and animation styles
  • Lucide React - Beautiful icon library
  • Responsive Design - Mobile-first approach

Build Tools

  • Vite 5.4.10 - Fast build tool and dev server
  • PostCSS 8.4.35 - CSS processing
  • Autoprefixer 10.4.18 - Automatic vendor prefixing

HTTP & Communication

  • Axios 1.10.0 - HTTP client for API calls
  • REST API Integration - Backend communication
  • Real-time Updates - Dynamic content fetching

Development Tools

  • TypeScript - Static type checking
  • React DevTools - Development debugging
  • Hot Module Replacement - Fast development iteration

πŸ“ Project Structure

frontend/
β”œβ”€β”€ public/                    # Static assets
β”‚   β”œβ”€β”€ AppTeam.png           # Team logo and branding
β”‚   β”œβ”€β”€ img1.png - img12.jpeg # Project screenshots
β”‚   └── ...                   # Other static files
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/           # Reusable components
β”‚   β”‚   β”œβ”€β”€ About.tsx        # About section
β”‚   β”‚   β”œβ”€β”€ Achievements.tsx # Team achievements
β”‚   β”‚   β”œβ”€β”€ AnimatedBackground.tsx # Background animations
β”‚   β”‚   β”œβ”€β”€ CodeRain.tsx     # Matrix-style animation
β”‚   β”‚   β”œβ”€β”€ Contact.tsx      # Contact form
β”‚   β”‚   β”œβ”€β”€ Footer.tsx       # Site footer
β”‚   β”‚   β”œβ”€β”€ GlassCard.tsx    # Glassmorphism card component
β”‚   β”‚   β”œβ”€β”€ GlowButton.tsx   # Animated button component
β”‚   β”‚   β”œβ”€β”€ Header.tsx       # Navigation header
β”‚   β”‚   β”œβ”€β”€ Hero.tsx         # Landing section
β”‚   β”‚   β”œβ”€β”€ JoinTeam.tsx     # Team recruitment section
β”‚   β”‚   β”œβ”€β”€ MemberForm.tsx   # Member profile form
β”‚   β”‚   β”œβ”€β”€ NewsSection.tsx  # News and updates
β”‚   β”‚   β”œβ”€β”€ Projects.tsx     # Project showcase
β”‚   β”‚   β”œβ”€β”€ Services.tsx     # Team services
β”‚   β”‚   β”œβ”€β”€ Team.tsx         # Team member profiles
β”‚   β”‚   β”œβ”€β”€ TeamApplication.tsx # Application form
β”‚   β”‚   └── Workshops.tsx    # Workshop information
β”‚   β”œβ”€β”€ pages/               # Page components
β”‚   β”‚   β”œβ”€β”€ AdminPage.tsx    # Admin dashboard
β”‚   β”‚   β”œβ”€β”€ AnnouncementsPage.tsx # Announcements
β”‚   β”‚   β”œβ”€β”€ AddMembersPage.tsx # Member management
β”‚   β”‚   └── NoMatch.tsx      # 404 error page
β”‚   β”œβ”€β”€ App.tsx              # Main application component
β”‚   β”œβ”€β”€ main.tsx             # Application entry point
β”‚   β”œβ”€β”€ index.css            # Global styles and Tailwind
β”‚   └── vite-env.d.ts        # Vite type definitions
β”œβ”€β”€ package.json             # Dependencies and scripts
β”œβ”€β”€ tailwind.config.js       # Tailwind configuration
β”œβ”€β”€ tsconfig.json           # TypeScript configuration
β”œβ”€β”€ vite.config.ts          # Vite configuration
└── README.md               # This file

πŸš€ Getting Started

Prerequisites

  • Node.js (v18 or higher)
  • npm or yarn package manager

Installation

  1. Clone the repository

    git clone <repository-url>
    cd App-Team/frontend
  2. Install dependencies

    npm install
  3. Environment Setup Create a .env file in the root directory:

    VITE_BACKEND_URI=your-backend-api-url
  4. Start development server

    npm run dev

    The application will be available at http://localhost:3000

Build for Production

npm run build

Preview Production Build

npm run preview

🌐 API Integration

The frontend communicates with a backend API for:

  • Member Management - CRUD operations for team members
  • Team Applications - Application submission and management
  • Contact Forms - Message handling and notifications
  • Announcements - News and updates management
  • Authentication - Admin access control

πŸ“± Responsive Design

The application is optimized for:

  • Mobile Devices (320px - 768px)
  • Tablets (768px - 1024px)
  • Desktop (1024px+)
  • 4K Displays (1920px+)

🎨 Design System

Color Palette

  • Primary Dark: #0A0F1C - Main background
  • Secondary Dark: #1A1F2E - Card backgrounds
  • Accent Blue: #3B82F6 - Primary actions
  • Accent Purple: #8B5CF6 - Secondary accents
  • Success Green: #10B981 - Success states
  • Warning Orange: #F59E0B - Warning states

Typography

  • Sansita: Primary font for headings and UI
  • System Fonts: Fallback for performance

Components

  • GlassCard: Reusable glassmorphism container
  • GlowButton: Animated call-to-action buttons
  • Loading Spinners: Consistent loading states
  • Toast Notifications: User feedback system

πŸ”’ Admin Features

The admin panel (/xjfhe839) includes:

  • Member Management: Add, edit, delete team members
  • Application Review: Review and manage team applications
  • Announcement System: Create and manage announcements
  • Content Management: Update team information
  • Analytics: View application statistics

πŸ“„ Available Scripts

Script Description
npm run dev Start development server with hot reload
npm run build Build for production
npm run preview Preview production build locally

🀝 Contributing

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature-name
  3. Commit changes: git commit -m "Add feature"
  4. Push to branch: git push origin feature-name
  5. Submit a pull request

πŸ“ License

This project is proprietary to AppTeam NIT Hamirpur.

πŸ‘₯ Team

Built with ❀️ by the AppTeam NIT Hamirpur development team.


AppTeam NIT Hamirpur - Building the future through innovation and code