Skip to content

AparmitSrivastava/asHelp

 
 

Repository files navigation

AsHelp Logo

AsHelp - Academic Assignment Platform

Connecting students with verified toppers for seamless academic assistance

Next.js TypeScript Supabase Tailwind CSS License: MIT Hacktoberfest


Key Features

  • Assignment Upload - Seamless PDF file upload with drag & drop interface
  • Payment Integration - Razorpay payment gateway with multiple payment options
  • User Dashboard - Personal dashboard for managing assignments and profile
  • Secure Authentication - Email/password & Google OAuth via Supabase Auth
  • Interactive Forms - Dynamic forms for user registration and data input
  • Background Effects - Aurora and particle effects for enhanced visual appeal
  • Animated Components - Custom text animations, loaders, and transitions
  • Fully Responsive - Optimized for desktop, tablet & mobile devices
  • Modern UI - Clean interface with Tailwind CSS & custom components
  • Blazing Fast - Built with Next.js 15 and Turbopack for optimal performance

Tech Stack

Frontend:

  • Next.js 15.3 (App Router)
  • React 19
  • TypeScript
  • Tailwind CSS 4.1
  • Framer Motion & GSAP

Backend & Services:

  • Supabase (Database, Auth, Storage)
  • Vercel (Hosting)

UI & Components:

  • Radix UI Primitives
  • Lucide Icons
  • Magic UI Components

Quick Start

Prerequisites

  • Node.js 18+ and npm
  • Supabase account

Installation

  1. Clone the repository

    git clone https://github.com/Harshdev625/asHelp.git
    cd asHelp
  2. Install dependencies

    npm install
  3. Environment Setup

    Create a .env.local file in the root directory:

    # Supabase Configuration
    NEXT_PUBLIC_SUPABASE_URL=your_supabase_project_url
    NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key
  4. Supabase Setup

    • Create a new project at Supabase Dashboard
    • Enable Authentication providers (Email, etc.)
    • Create storage bucket: assignments
  5. Run the development server

    npm run dev
  6. Open your browser

    Navigate to http://localhost:3000

Screenshots / Demo

Platform Preview

AsHelp Homepage

Homepage - Modern landing page with clean design

Login Page

Login Interface - Secure authentication system

Note: Screenshots show the current UI design. The interface may evolve as new features are added.

Live Demo

🚀 View Live Demo (Coming Soon)

For a complete walkthrough, check out our demo video showcasing key features and user flows.

Project Structure

asHelp/
├── src/
│   ├── app/                      # Next.js App Router
│   │   ├── layout.tsx           # Root layout
│   │   ├── page.tsx             # Home page
│   │   ├── globals.css          # Global styles
│   │   ├── api/                 # API routes
│   │   ├── dashboard/           # Dashboard pages
│   │   ├── form/                # Form pages
│   │   ├── payment/             # Payment integration
│   │   └── sign/                # Authentication
│   ├── components/              # Reusable components
│   │   ├── nav.tsx              # Navigation
│   │   ├── upload.tsx           # File upload
│   │   ├── ui/                  # UI primitives
│   │   ├── magicui/             # Animated components
│   │   └── Backgrounds/         # Background effects
│   └── lib/                     # Utilities
│       ├── supabaseclient.ts    # Supabase config
│       └── utils.ts             # Helper functions
├── public/                      # Static assets
└── Configuration files

Available Scripts

Command Description
npm run dev Start development server with Turbopack
npm run build Build for production
npm run start Start production server
npm run lint Run ESLint

Contributing

  1. Fork the repository
  2. Create your feature branch
    git checkout -b feature/AmazingFeature
  3. Commit your changes
    git commit -m 'Add some AmazingFeature'
  4. Push to the branch
    git push origin feature/AmazingFeature
  5. Open a Pull Request

Code of Conduct

We are committed to fostering a welcoming and inclusive community. Please read our Code of Conduct to understand the standards we expect from all contributors.

Quick Summary:

  • Be respectful and considerate in all interactions
  • Use inclusive language and avoid discriminatory behavior
  • Accept constructive feedback gracefully
  • Focus on what's best for the community
  • Show empathy towards other community members

For detailed guidelines, please see our full Code of Conduct.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments


Built with ❤️ using modern web technologies

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 97.1%
  • CSS 1.9%
  • Other 1.0%