Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Emmanuel-Mtz-777/TechStore-Explorer/llms.txt

Use this file to discover all available pages before exploring further.

TechStore Explorer lets users browse thousands of tech products sourced from the Platzi Fake Store API, save favorites to a personal wishlist, and receive email confirmations for every wishlist change. Administrators get a dedicated analytics dashboard and full control over user roles through a REST API secured with Laravel Sanctum.

Quickstart

Install dependencies, configure your environment, and get TechStore Explorer running locally in minutes.

Configuration

Explore every environment variable — database, mail, app settings, and queue configuration.

API Reference

Full REST API documentation with request/response examples for all Sanctum-protected endpoints.

Deployment

Deploy to Railway with a three-service architecture: web server, MySQL database, and queue worker.

​
What’s Inside

TechStore Explorer is built with Laravel 13, Livewire 3, Vue 3, and Tailwind CSS. It connects to the Platzi Fake Store API for product data and stores user wishlists in a MySQL database.

Product Browser

Category filtering and offset-based pagination powered by real-time Livewire components.

Wishlist

Add or remove products with queued email notifications sent via Mailtrap.

Authentication

Laravel Sanctum-backed auth with email verification, password reset, and role assignment.

Admin Dashboard

Analytics charts showing favorite categories, top products, average prices, and active users.

REST API

Sanctum-secured API endpoints for auth, wishlist, and role management.

Email Notifications

Mailtrap sandbox integration with Laravel queues for async email delivery.

​
Get Running in 4 Steps

1

Clone and install dependencies

Clone the repository, then install PHP and Node.js dependencies.
git clone https://github.com/Emmanuel-Mtz-777/TechStore-Explorer.git
cd TechStore-Explorer
composer install
npm install
2

Configure your environment

Copy the example environment file, generate an app key, and fill in your database and mail credentials.
cp .env.example .env
php artisan key:generate
3

Run migrations and seed the database

Create the schema and seed the two default roles plus admin and customer test accounts.
php artisan migrate --seed
4

Start all services

Use the Composer dev script to start the web server, queue listener, log viewer, and Vite in one command.
composer run dev
The app will be available at http://127.0.0.1:8000.
The queue listener must be running for wishlist email notifications to be delivered. The composer run dev script starts it automatically alongside the web server.

Build docs developers (and LLMs) love

Get started for freeTalk to us