Skip to main content
Get your Luis IT Repair system up and running quickly with this streamlined guide. This quickstart will take you from a fresh Firebase project to your first service order in about 15 minutes.

​
Prerequisites

Before you begin, make sure you have:
  • Node.js 20 or higher installed
  • A Google account for Firebase
  • Git installed on your computer
  • Basic familiarity with the command line

​
Quick Setup

1

Clone the Repository

Clone the Luis IT Repair repository to your local machine:
git clone https://github.com/lechug1122/LuisITRepair.git
cd LuisITRepair
2

Install Dependencies

Install all required npm packages:
npm install
This will install React, Firebase, Vite, and all other dependencies.
3

Create Firebase Project

  1. Go to Firebase Console
  2. Click Add project
  3. Enter a project name (e.g., luis-it-repair-prod)
  4. Enable Google Analytics (optional)
  5. Click Create Project
4

Register Web App

In your Firebase project:
  1. Click the web icon to add a web app
  2. Register your app with a nickname
  3. Copy the Firebase configuration object
5

Configure Firebase SDK

Update src/initializer/firebase.js with your Firebase credentials:
src/initializer/firebase.js
import { initializeApp } from "firebase/app";
import { getFirestore } from "firebase/firestore";
import { getAuth } from "firebase/auth";

const firebaseConfig = {
  apiKey: "YOUR_API_KEY",
  authDomain: "your-project.firebaseapp.com",
  projectId: "your-project-id",
  storageBucket: "your-project.firebasestorage.app",
  messagingSenderId: "YOUR_SENDER_ID",
  appId: "YOUR_APP_ID"
};

const app = initializeApp(firebaseConfig);
export const db = getFirestore(app);
export const auth = getAuth(app);
Never commit real Firebase credentials to public repositories.
6

Enable Authentication

In Firebase Console:
  1. Go to Authentication → Get Started
  2. Enable Email/Password sign-in method
  3. Save the changes
7

Create Firestore Database

In Firebase Console:
  1. Go to Firestore Database → Create database
  2. Start in Production mode
  3. Choose a location close to your users
  4. Click Enable
8

Deploy Security Rules

Install Firebase CLI and deploy the security rules:
npm install -g firebase-tools
firebase login
firebase init
firebase deploy --only firestore:rules
Select your project and choose Firestore when prompted.
9

Create Admin User

  1. In Firebase Console, go to Authentication → Users
  2. Click Add User
  3. Enter email: [email protected] and a password
  4. Copy the UID
  5. In Firestore Database, create a document in the autorizados collection:
{
  "uid": "<paste-uid-here>",
  "email": "[email protected]",
  "rol": "Administrador",
  "online": false,
  "lastActive": null,
  "versionVista": "1.5.0"
}
10

Start Development Server

Run the development server:
npm run dev
Open your browser to http://localhost:5173 and you should see the login page.

​
Test Your Setup

1

Login

Use the admin credentials you created to log in to the system.
2

Create Your First Service Ticket

  1. Navigate to Hoja de Servicio (Service Sheet)
  2. Enter customer information (name, phone)
  3. Fill in device details (type, brand, model)
  4. Add service description and issue
  5. Click Guardar (Save)
You should see a confirmation with the generated folio number!
3

View Service Status

Open a new browser tab and go to /status to see the public service status page where customers can check their repairs.

​
Next Steps

Complete Installation

Deploy to production with Firebase Hosting

Configure POS

Set up the Point of Sale system

Explore Features

Learn about all available features

API Reference

Explore the service API

​
Troubleshooting

  1. Check that Firebase Authentication is enabled
  2. Verify the user exists in Firebase Authentication
  3. Ensure the user’s UID is in the autorizados Firestore collection
  4. Check browser console for specific error messages
  1. Verify Firestore security rules are deployed
  2. Check that you’re logged in with an authenticated user
  3. Open browser DevTools Network tab to see if requests are being blocked
  4. Ensure the servicios collection has proper write permissions for authenticated users
  1. Ensure Node.js 20+ is installed: node --version
  2. Delete node_modules and package-lock.json, then run npm install again
  3. Check that port 5173 is not already in use
  4. Look for error messages in the terminal output
  1. Double-check all Firebase config values in src/initializer/firebase.js
  2. Ensure there are no quotes or special characters in the config values
  3. Verify the project ID matches your Firebase project
  4. Try creating a fresh Firebase config from the Firebase Console
For production deployment with Firebase Hosting, custom domains, and advanced configuration, see the complete installation guide.

Build docs developers (and LLMs) love

Get started for freeTalk to us