Skip to content

ratacueva-org/web-app

RataCueva Web App — Gaming Ecommerce Frontend

Next.js React TypeScript TailwindCSS GPL v3

Customer-facing ecommerce platform for video games, PC components, and gaming accessories

Report Bug · Visit Website

🇬🇧 English · 🇪🇸 Español


About RataCueva Web App

A modern, responsive ecommerce frontend built with Next.js 15 and React 19. Features a complete product catalog, advanced search and filtering, shopping cart, user authentication, and a comprehensive admin dashboard for inventory and order management.

Ecosystem

Component Repository Stack
Web App (this) ratacueva-org/ratacueva-web Next.js, TypeScript, TailwindCSS
Backend API ratacueva-org/ratacueva-api Express, TypeScript, MongoDB

Features

  • Complete gaming product catalog with categories and search
  • Advanced filtering by price, category, and specifications
  • Shopping cart with optimized checkout flow
  • User authentication and account management
  • Admin dashboard for products, orders, and users
  • Responsive design for all devices
  • Framer Motion animations for smooth interactions

Quick Start

Prerequisites

  • Node.js 18+
  • npm or yarn

Setup

git clone https://github.com/ratacueva-org/ratacueva-web.git
cd ratacueva-web
npm install

Environment Variables

Create a .env.local file:

NEXT_PUBLIC_API_URL=http://localhost:3001
NEXTAUTH_SECRET=your_secret_key

Run

npm run dev

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

Architecture

src/
├── app/
│   ├── (auth)/          # Authentication routes
│   ├── (dashboard)/     # Admin dashboard
│   └── (shop)/          # Online store
├── components/
│   ├── atoms/           # Basic components
│   ├── features/        # Feature-specific components
│   └── organisms/       # Complex components
├── hooks/               # Custom hooks
├── services/            # API services
└── contexts/            # React contexts

Contributing

Please read CONTRIBUTING.md for branch naming, commit conventions, and PR workflow.

License

This project is licensed under the GPL v3 — see the LICENSE file for details.

Acknowledgments

Authors:

  • Serrano Puertos Jorge Christian
  • Chavez Moreno Jose Eduardo
  • Lopez Valdes Erick Ernesto
  • Florentino Altamirano Misrael

About

E-commerce platform for gaming products — video games, PC components, and accessories (Next.js, TypeScript, TailwindCSS)

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages