Skip to main content

​
Build Your Ultimate PC

A modern e-commerce platform built with Astro, React, and Express, delivering extreme performance and seamless shopping experiences for PC hardware enthusiasts.

Get StartedView on GitHub

​
Key Features

PC Fix combines cutting-edge web technologies to deliver a best-in-class e-commerce experience.

Extreme Performance

95+ Lighthouse score with Astro SSR and React islands for instant page loads

Multi-Payment Support

MercadoPago, cryptocurrency (USDT), and offline payment options

Smart Inventory

Real-time stock tracking with automated alerts and inactive product detection

Admin Dashboard

Comprehensive analytics, metrics visualization, and full CRUD operations

Quickstart

Get PC Fix running locally in minutes with Docker

Architecture

Understand the monorepo structure and tech stack

API Reference

Explore REST API endpoints for all features

Environment Setup

Configure environment variables and services

Database Schema

Learn about the PostgreSQL data model

Testing Guide

Run unit tests and E2E tests with Vitest and Playwright

​
Tech Stack Highlights

  • Astro 5: Hybrid SSR/static rendering with ViewTransitions
  • React 18: Interactive islands for cart, checkout, and admin features
  • Tailwind CSS: Utility-first styling with responsive design
  • Zustand: Lightweight state management for cart and user session
  • React Hook Form + Zod: Type-safe form handling and validation
  • Express 5: Modern RESTful API with async middleware support
  • Prisma 6: Type-safe ORM with PostgreSQL
  • JWT + Bcrypt: Secure authentication and password hashing
  • Rate Limiting + Helmet: Protection against abuse and security headers
  • Node-cron: Background jobs for cart expiration and alerts
  • MercadoPago SDK: Payment gateway integration
  • Cloudinary: CDN for product images
  • Google OAuth: Social login with google-auth-library
  • Resend: Transactional email service
  • Sentry: Error monitoring for frontend and backend
  • Docker Compose: Containerized development environment
  • Vercel + Railway: Production deployment

​
What Makes PC Fix Different?

PC Fix achieves a 95+ Lighthouse performance score by combining Astro’s server islands with selective React hydration, ensuring instant page loads without sacrificing interactivity.
Unlike traditional e-commerce platforms, PC Fix is built as a monorepo using NPM workspaces, allowing shared TypeScript types, validation schemas, and utilities between frontend and backend. This architectural choice eliminates duplication and ensures type safety across the entire stack. The platform supports hybrid payment flows including traditional credit cards (MercadoPago), cryptocurrency (USDT), and offline payment methods, making it adaptable to diverse market requirements.

​
Get Started

1

Clone the repository

git clone https://github.com/martin-ratti/PCFIX-Baru.git
cd PCFIX-Baru
2

Configure environment

Set up .env files for both packages/api and packages/web with your database credentials and API keys.
3

Launch with Docker

docker-compose up --build
Access the frontend at http://localhost:4321 and API at http://localhost:3002

Need Help?

Visit the GitHub repository for issues, discussions, and community support.

Build docs developers (and LLMs) love

Get started for freeTalk to us