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.

Get TechStore Explorer running on your local machine in just a few minutes. This guide walks you through cloning the repository, installing dependencies, wiring up the database, seeding test data, and launching every required process so the app is fully functional from the first request.
1

Clone the repository

Clone the repository from GitLab and navigate into the project directory:
git clone git@gitlab.com:usuario/TechStore-Explorer.git
cd TechStore-Explorer
2

Install PHP dependencies

Install all backend PHP packages via Composer:
composer install
3

Install Node.js dependencies

Install the frontend JavaScript dependencies. The project was developed with pnpm but is fully compatible with npm:
pnpm install
4

Configure the environment

Copy the example environment file to create your local .env, then generate a unique application key:
cp .env.example .env
php artisan key:generate
5

Configure the database

Open the .env file you just created and update the database connection variables to match your local MySQL setup:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=techexplorer
DB_USERNAME=root
DB_PASSWORD=password
Make sure the database (techexplorer in the example above) exists in MySQL before running migrations.
6

Run migrations and seed

Run all database migrations and seed the initial data in a single command:
php artisan migrate --seed
The seeder creates two roles (admin and customer) via RoleSeeder, then creates two test user accounts — one for each role — so you can log in immediately after setup.
7

Compile frontend assets

Build the Tailwind CSS, Vue 3, and Vite assets. Use dev mode while working locally, and build for production:
pnpm dev

pnpm build
8

Start the server

Launch the Laravel development server:
php artisan serve
The application is now available at http://127.0.0.1:8000.
9

Start the queue worker

Open a separate terminal and start the queue worker:
php artisan queue:work
The queue worker is required for email notifications to be sent. When a user adds or removes a product from their wishlist, the email job is dispatched to the database queue — if the worker is not running, those jobs will sit in the queue unprocessed and no emails will be delivered.
Recommended for development: the Composer dev script starts the server, queue listener (queue:listen), Pail log watcher, and Vite all at once in a single terminal using concurrently:
composer run dev
This is the fastest way to spin up a complete development environment without juggling multiple terminal windows.

​
Test Credentials

Two accounts are created automatically by the seeder and are ready to use immediately:
FieldValue
Emailadmin@example.com
Passwordadmin123
Roleadmin
The admin account has access to role management API endpoints and the admin analytics dashboard.

Build docs developers (and LLMs) love

Get started for freeTalk to us