Alexandru Eduard Farcas fb6489bbec Read me update 2.0
2025-05-27 13:56:09 +03:00
2025-05-05 21:42:29 +03:00
2025-05-24 16:05:57 +03:00
2025-05-27 12:21:09 +03:00
2025-04-26 22:31:07 +03:00
2025-05-18 10:15:18 +03:00
2025-05-18 10:15:18 +03:00
2025-05-18 10:31:12 +03:00
2025-05-27 13:56:09 +03:00

Giveaway Site

A modern web application for hosting and managing giveaways, built with Next.js, TypeScript, and Tailwind CSS.

Features

  • Next.js App Router for fast, scalable routing and SSR/SSG.
  • 🛠️ TypeScript for type safety and better developer experience.
  • 🎨 Tailwind CSS for utility-first, responsive UI design.
  • 🗂️ App Directory Structure for modular, maintainable code.
  • 🔤 next/font for optimized font loading (Geist).
  • 🔒 Environment Variables for secure configuration.
  • 🔑 Google Authentication for secure user sign-in and account management.
  • 📺 YouTube API Integration to interact with YouTube data for giveaway requirements or validation.
  • 🗄️ PostgreSQL Database managed with Prisma ORM and hosted on Railway for scalable, reliable data storage.
  • 🚀 Ready for Vercel Deployment with zero-config.

Getting Started

  1. Install dependencies:

    npm install
    # or
    yarn install
    # or
    pnpm install
    # or
    bun install
    
  2. Run the development server:

    npm run dev
    # or
    yarn dev
    # or
    pnpm dev
    # or
    bun dev
    
  3. Open http://localhost:3000 in your browser.

Project Structure

  • app/ — Main application pages and routes.
  • components/ — Reusable UI components.
  • styles/ — Global and Tailwind CSS styles.
  • public/ — Static assets.
  • next.config.js — Next.js configuration.
  • tsconfig.json — TypeScript configuration.
  • prisma/ — Prisma schema and migrations.
  • .env — Environment variables for API keys and database connection.

Technologies Used

  • Next.js — React framework for production.
  • TypeScript — Static typing for JavaScript.
  • Tailwind CSS — Utility-first CSS framework.
  • next/font — Font optimization.
  • Google Authentication — Secure OAuth 2.0 login.
  • YouTube API — Integration for YouTube data.
  • PostgreSQL — Relational database.
  • Prisma — Type-safe ORM for database access.
  • Railway — Cloud database hosting.
  • Vercel — Deployment platform.

Deployment

Deploy instantly to Vercel for best performance and global reach.

Learn More


Feel free to contribute or open issues to improve the project!

S
Description
A React-based giveaway management app with features for creating, managing, and selecting winners for giveaways.
Readme 468 KiB
Languages
TypeScript 96.8%
JavaScript 2.2%
CSS 1%