Skip to main content

Quick Start

Get ESBO Web up and running on your local development environment in just a few steps. This guide will have you viewing the landing page locally in under 5 minutes.
Make sure you have Node.js installed on your system before proceeding. See the Installation guide for detailed prerequisites.

Get Started in 4 Steps

1

Clone the repository

Clone the ESBO Web repository from GitHub to your local machine:
git clone https://github.com/SiroCarv/esbo-web.git
cd esbo-web
This downloads the complete source code including all assets and configuration files.
2

Install dependencies

Install all required packages using your preferred package manager:
npm install
This installs React 19, Vite, Tailwind CSS, Lucide React icons, and all development dependencies.
3

Start the development server

Launch the Vite development server with hot module replacement:
npm run dev
The dev script runs vite which starts the development server with instant HMR (Hot Module Replacement).
4

Open in your browser

Once the server starts, you’ll see output similar to:
VITE v7.3.1  ready in 324 ms

  Local:   http://localhost:5173/
  Network: use --host to expose
  press h + enter to show help
Open your browser and navigate to http://localhost:5173/ to view the ESBO Web landing page.

What You’ll See

Once the development server is running, you’ll see the complete ESBO landing page with:
  • Header Navigation: ESBO logo and student/staff access button
  • Hero Section: Dual-image hero with “SINTEGRA: Salud Mental y Formación de Excelencia” tagline
  • Service Icons: Academic repository, international partnerships, and certificate validation
  • Contact Section: Email addresses, phone number, and social media links
  • Footer: FAQ button and search functionality
  • Floating Chat: Interactive chat widget in the bottom-right corner
The development server includes hot module replacement (HMR), so any changes you make to the code will instantly reflect in the browser without a full page reload.

Available Scripts

ESBO Web includes several npm scripts for different tasks:
{
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "lint": "eslint .",
    "preview": "vite preview"
  }
}

Development

npm run dev
Starts the Vite development server with HMR on http://localhost:5173/

Production Build

npm run build
Creates an optimized production build in the dist/ directory

Lint Code

npm run lint
Runs ESLint to check for code quality issues and potential errors

Preview Build

npm run preview
Serves the production build locally for testing before deployment

Next Steps

Installation Guide

Learn about prerequisites, troubleshooting, and detailed setup instructions

Project Structure

Understand the technologies and architecture behind ESBO Web

Customization

Customize colors, content, and components for your needs

Deployment

Deploy your changes to production with Vercel
Don’t commit sensitive information like API keys or credentials. ESBO Web is a static landing page and doesn’t require environment variables in Phase 1.

Build docs developers (and LLMs) love