Skip to content

Repository files navigation

Pick Me A - Entertainment Discovery Hub 🎬🎡🎌

preview

Live Site Peerlist Product Hunt


React TypeScript Vite Tailwind MIT

An immersive cinematic hub for discovering your next favorite anime, movies, and music

✨ Features

  • 🎌 AniePick - Discover amazing anime series and movies
  • 🎬 CinePick - Find your next favorite films and cinema
  • 🎡 MeloPick - Explore new music and artists
  • 🌌 Immersive 3D Portal Experience - Interactive portal cards with stunning visual effects
  • πŸ“± Responsive Design - Beautiful experience across all devices
  • 🎨 Dynamic Themes - Unique visual themes for each entertainment category

🎯 Connected Platforms

🎌 AniePick - Anime Discovery

AniePick Status GitHub Repo Jikan API v4 API Status

  • Theme: Japanese-inspired with cherry blossom particles
  • Color: Deep Red (#dc2626)
  • Features: Personalized anime recommendations
  • Database: 10,000+ anime titles

🎬 CinePick - Movie Discovery

CinePick Status GitHub Repo IMDb API API Status

  • Theme: Hollywood glamour with film strip elements
  • Color: Golden Yellow (#fbbf24)
  • Features: Smart movie matching algorithm
  • Integration: Powered by The Movie Database

🎡 MeloPick - Music Discovery

MeloPick Status GitHub Repo Spotify API API Status

  • Theme: Audio-visual with soundwave animations
  • Color: Neon Green (#10b981)
  • Features: AI-powered music recommendations
  • Integration: Spotify API for seamless discovery

πŸ› οΈ Built With

  • Frontend Framework: React 18 with TypeScript
  • Build Tool: Vite
  • Styling: Tailwind CSS with custom design system
  • 3D Graphics: React Three Fiber & Three.js
  • UI Components: Radix UI with shadcn/ui
  • Routing: React Router DOM
  • State Management: TanStack Query
  • Icons: Lucide React

🏁 Quick Start

Prerequisites

  • Node.js 18+ or Bun
  • npm, yarn, or bun package manager

Installation

# Clone the repository
git clone https://github.com/your-username/pick-me-a.git

# Navigate to project directory
cd pick-me-a

# Install dependencies
npm install
# or
bun install

# Start development server
npm run dev
# or
bun dev

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

πŸ“ Project Structure

β”œβ”€β”€ .gitignore
β”œβ”€β”€ LICENSE
β”œβ”€β”€ README.md
β”œβ”€β”€ bun.lockb
β”œβ”€β”€ components.json
β”œβ”€β”€ eslint.config.js
β”œβ”€β”€ index.html
β”œβ”€β”€ package-lock.json
β”œβ”€β”€ package.json
β”œβ”€β”€ postcss.config.js
β”œβ”€β”€ public
    β”œβ”€β”€ placeholder.svg
    └── surprise-box.png
β”œβ”€β”€ src
    β”œβ”€β”€ App.css
    β”œβ”€β”€ App.tsx
    β”œβ”€β”€ assets
    β”‚   β”œβ”€β”€ anime-eye-icon.png
    β”‚   β”œβ”€β”€ cine-pick-logo.png
    β”‚   β”œβ”€β”€ cinematic-entertainment-background.jpg
    β”‚   β”œβ”€β”€ cinepick-logo2.png
    β”‚   β”œβ”€β”€ enhanced-panoramic-entertainment-universe.jpg
    β”‚   β”œβ”€β”€ equalizer-icon.png
    β”‚   β”œβ”€β”€ film-reel-icon.png
    β”‚   β”œβ”€β”€ melopick-logo.png
    β”‚   β”œβ”€β”€ melopick-logo2.png
    β”‚   β”œβ”€β”€ panoramic-entertainment-background.jpg
    β”‚   β”œβ”€β”€ panoramic-entertainment-universe.jpg
    β”‚   β”œβ”€β”€ pick.jpg
    β”‚   β”œβ”€β”€ pick2.png
    β”‚   β”œβ”€β”€ pick3.png
    β”‚   β”œβ”€β”€ sugoi-pick-logo.png
    β”‚   └── sugoipick-logo1.png
    β”œβ”€β”€ components
    β”‚   β”œβ”€β”€ AdvancedCursorEffects.tsx
    β”‚   β”œβ”€β”€ CinematicTitle.tsx
    β”‚   β”œβ”€β”€ Enhanced3DPortalCard.tsx
    β”‚   β”œβ”€β”€ EnhancedPortalCard.tsx
    β”‚   β”œβ”€β”€ EnhancedPortalTransition.tsx
    β”‚   β”œβ”€β”€ Portal3D.tsx
    β”‚   β”œβ”€β”€ PortalCard.tsx
    β”‚   β”œβ”€β”€ PortalCardEffects.tsx
    β”‚   β”œβ”€β”€ PortalCardIcon.tsx
    β”‚   β”œβ”€β”€ PortalTransition.tsx
    β”‚   β”œβ”€β”€ SimpleBackground.tsx
    β”‚   β”œβ”€β”€ SimpleCursorEffects.tsx
    β”‚   β”œβ”€β”€ UniverseBackground.tsx
    β”‚   └── ui
    β”‚   β”‚   β”œβ”€β”€ accordion.tsx
    β”‚   β”‚   β”œβ”€β”€ alert-dialog.tsx
    β”‚   β”‚   β”œβ”€β”€ alert.tsx
    β”‚   β”‚   β”œβ”€β”€ aspect-ratio.tsx
    β”‚   β”‚   β”œβ”€β”€ avatar.tsx
    β”‚   β”‚   β”œβ”€β”€ badge.tsx
    β”‚   β”‚   β”œβ”€β”€ breadcrumb.tsx
    β”‚   β”‚   β”œβ”€β”€ button.tsx
    β”‚   β”‚   β”œβ”€β”€ calendar.tsx
    β”‚   β”‚   β”œβ”€β”€ card.tsx
    β”‚   β”‚   β”œβ”€β”€ carousel.tsx
    β”‚   β”‚   β”œβ”€β”€ chart.tsx
    β”‚   β”‚   β”œβ”€β”€ checkbox.tsx
    β”‚   β”‚   β”œβ”€β”€ collapsible.tsx
    β”‚   β”‚   β”œβ”€β”€ command.tsx
    β”‚   β”‚   β”œβ”€β”€ context-menu.tsx
    β”‚   β”‚   β”œβ”€β”€ dialog.tsx
    β”‚   β”‚   β”œβ”€β”€ drawer.tsx
    β”‚   β”‚   β”œβ”€β”€ dropdown-menu.tsx
    β”‚   β”‚   β”œβ”€β”€ form.tsx
    β”‚   β”‚   β”œβ”€β”€ hover-card.tsx
    β”‚   β”‚   β”œβ”€β”€ input-otp.tsx
    β”‚   β”‚   β”œβ”€β”€ input.tsx
    β”‚   β”‚   β”œβ”€β”€ label.tsx
    β”‚   β”‚   β”œβ”€β”€ menubar.tsx
    β”‚   β”‚   β”œβ”€β”€ navigation-menu.tsx
    β”‚   β”‚   β”œβ”€β”€ pagination.tsx
    β”‚   β”‚   β”œβ”€β”€ popover.tsx
    β”‚   β”‚   β”œβ”€β”€ progress.tsx
    β”‚   β”‚   β”œβ”€β”€ radio-group.tsx
    β”‚   β”‚   β”œβ”€β”€ resizable.tsx
    β”‚   β”‚   β”œβ”€β”€ scroll-area.tsx
    β”‚   β”‚   β”œβ”€β”€ select.tsx
    β”‚   β”‚   β”œβ”€β”€ separator.tsx
    β”‚   β”‚   β”œβ”€β”€ sheet.tsx
    β”‚   β”‚   β”œβ”€β”€ sidebar.tsx
    β”‚   β”‚   β”œβ”€β”€ skeleton.tsx
    β”‚   β”‚   β”œβ”€β”€ slider.tsx
    β”‚   β”‚   β”œβ”€β”€ sonner.tsx
    β”‚   β”‚   β”œβ”€β”€ switch.tsx
    β”‚   β”‚   β”œβ”€β”€ table.tsx
    β”‚   β”‚   β”œβ”€β”€ tabs.tsx
    β”‚   β”‚   β”œβ”€β”€ textarea.tsx
    β”‚   β”‚   β”œβ”€β”€ toast.tsx
    β”‚   β”‚   β”œβ”€β”€ toaster.tsx
    β”‚   β”‚   β”œβ”€β”€ toggle-group.tsx
    β”‚   β”‚   β”œβ”€β”€ toggle.tsx
    β”‚   β”‚   β”œβ”€β”€ tooltip.tsx
    β”‚   β”‚   └── use-toast.ts
    β”œβ”€β”€ hooks
    β”‚   β”œβ”€β”€ use-mobile.tsx
    β”‚   └── use-toast.ts
    β”œβ”€β”€ index.css
    β”œβ”€β”€ lib
    β”‚   └── utils.ts
    β”œβ”€β”€ main.tsx
    β”œβ”€β”€ pages
    β”‚   β”œβ”€β”€ Index.tsx
    β”‚   └── NotFound.tsx
    └── vite-env.d.ts
β”œβ”€β”€ tailwind.config.ts
β”œβ”€β”€ tsconfig.app.json
β”œβ”€β”€ tsconfig.json
β”œβ”€β”€ tsconfig.node.json
└── vite.config.ts

🎨 Design System

The project uses a comprehensive design system with:

  • Custom HSL color tokens for theming
  • Semantic color variables for consistency
  • Responsive typography scale
  • Component variants for different states
  • Dark/light mode support

πŸš€ Deployment

Netlify (Recommended)

  1. Fork this repository
  2. Connect your GitHub account to Netlify
  3. Create a new site from your forked repository
  4. Update the Netlify badge URL in this README
  5. Deploy settings:
    • Build command: npm run build
    • Publish directory: dist

Other Platforms

The app can be deployed to any static hosting service:

  • Vercel
  • GitHub Pages
  • Firebase Hosting
  • AWS S3 + CloudFront

πŸ“± Browser Support

  • βœ… Chrome (latest)
  • βœ… Firefox (latest)
  • βœ… Safari (latest)
  • βœ… Edge (latest)

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the project
  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

πŸ“„ License

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

πŸ‘¨β€πŸ’» Author

DINESH S

GitHub LinkedIn

πŸ™ Acknowledgments


Made with ❀️ and AI assistance

About

An immersive cinematic hub for discovering anime, movies, and music. Find your next favorite entertainment with AniePick, CinePick, and MeloPick.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Contributors

Languages