Skip to main content

Huellitas Pet Shop Documentation

Learn how to build, deploy, and extend a modern full-stack e-commerce platform with React, .NET API, and PostgreSQL

Get StartedExplore API

Quick Start

Get Huellitas running locally in minutes

1

Clone the repository

Clone the Huellitas repository to your local machine:
git clone https://github.com/dominguezmicaela/petshopHuellitas.git
cd petshopHuellitas
2

Set up the backend

Navigate to the backend directory and configure your database connection:
cd huellitasBackEnd
dotnet restore
Create an appsettings.json file with your PostgreSQL connection string and JWT configuration.
{
  "ConnectionStrings": {
    "DefaultConnection": "Host=localhost;Database=huellitas;Username=postgres;Password=your_password"
  },
  "Jwt": {
    "Key": "your-secret-key-here",
    "Issuer": "HuellitasAPI",
    "Audience": "HuellitasClient"
  }
}
3

Run the API

Start the .NET API server:
cd Huellitas.API
dotnet run
The API will be available at http://localhost:5000. Visit http://localhost:5000/swagger to explore the API documentation.
4

Set up the frontend

In a new terminal, navigate to the frontend directory and install dependencies:
cd huellitas-frontend
npm install
npm run dev
The React app will be available at http://localhost:5173. You can now browse products, add items to your cart, and test the authentication flow.

Key Features

Everything you need for a modern e-commerce platform

Shopping Cart

LocalStorage-based cart system with add, remove, and quantity management

JWT Authentication

Secure user authentication with JSON Web Tokens and role-based access control

Admin Dashboard

Manage products, view user analytics, and monitor 580+ registered users

RESTful API

Well-documented endpoints with Swagger UI for products, orders, and authentication

Responsive Design

Mobile-first React components that work seamlessly on all devices

Data Pipeline

Python scripts for automated product categorization and data loading

Explore by Topic

Deep dive into different parts of the platform

Frontend Development

Learn about the React SPA architecture, component structure, routing with React Router, and state management

Explore frontend docs

Backend Development

Understand the .NET API architecture, Entity Framework Core models, repository pattern, and service layer

Explore backend docs

API Reference

Complete API documentation for authentication, products, and orders with request/response examples

View API reference

Deployment Guides

Deploy the backend to Render and the frontend to GitHub Pages with Docker containerization

View deployment guides

Ready to get started?

Follow our quickstart guide to set up Huellitas locally or explore the API reference to integrate with your own projects

Start Building