Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Minogar28/DIRECTORIO_UDC/llms.txt

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

Directorio UDC is a web application being built for the Universidad de Cundinamarca (UDC) with the goal of giving students and faculty a centralized place to discover advisory and tutoring spaces across campus. The project is currently in early development — the repository contains a working frontend scaffold and a minimal Express backend — and active feature development is ongoing.

The Problem It Solves

University campuses are busy environments where advisory hours shift each semester, rooms change, and new faculty join mid-year. Without a dedicated tool, students (estudiantes) must rely on informal channels — asking classmates, reading paper notices, or sending emails — to find out where and when they can get academic help. Faculty members face the mirror problem: they lack a shared, up-to-date channel to publish their availability. Directorio UDC aims to remove this friction by providing a live, searchable directory that both groups can rely on every day.

Current State

The application is a scaffold at this stage. The frontend is built on a standard Vite + React 19 + TypeScript setup and the backend is a minimal Express 5 server. Neither the advisory-space search UI, the faculty directory, nor the schedule view has been implemented yet. Those features are the intended end goal of the project.

Technology Stack

Directorio UDC is split into a frontend and a backend that will communicate over a REST API. Frontend
  • React 19 (^19.2.5) — UI library with the new React Compiler for automatic memoization
  • TypeScript ~6.0.2 — Static typing across all source files
  • Vite 8 (^8.0.10) — Next-generation build tool with instant HMR
  • @vitejs/plugin-react (^6.0.1) — Official Vite plugin for React support
  • babel-plugin-react-compiler (^1.0.0) — Experimental React Compiler Babel preset
  • eslint (^10.2.1) — Linting for TypeScript and TSX files
  • CSS Custom Properties — Theme variables for light and dark mode, defined in index.css
Backend
  • Node.js — JavaScript runtime for the API server
  • Express 5 (^5.2.1) — Fast, unopinionated web framework
  • cors (^2.8.6) — Cross-origin request handling middleware
  • path (^0.12.7) — Node.js path utilities
Directorio UDC is an internal university tool. It is designed exclusively for estudiantes (students) and docentes de planta (full-time faculty) of the Universidad de Cundinamarca. Access outside the university network may be restricted by your institution’s IT policies.

Project Layout

The repository is organized into two top-level directories — one for each tier of the application:
DIRECTORIO_UDC/
├── FRONTEND/          # React + TypeScript + Vite app
│   ├── src/
│   │   ├── App.tsx    # Root application component
│   │   ├── App.css    # Component-level styles
│   │   ├── index.css  # Global CSS variables and base styles
│   │   └── main.tsx   # React entry point
│   ├── public/        # Static assets
│   ├── index.html     # HTML shell
│   └── vite.config.ts # Vite configuration
└── BACKEND/           # Express.js API server
    └── package.json   # Backend dependencies
The FRONTEND directory is a Vite project scaffold enhanced with TypeScript strict mode and the experimental React Compiler Babel preset. The BACKEND directory contains a lightweight Express 5 server kept intentionally minimal to keep deployment simple.

What’s Planned

Architecture Overview

Learn how the React frontend and Express backend are structured and how data will flow between the two tiers.

Frontend Architecture

Explore the Vite + React 19 + TypeScript setup, the Vite configuration, and how the React Compiler is wired in.

Backend Architecture

Understand the Express 5 server structure, CORS configuration, and how the API layer is intended to be extended.

Local Setup Guide

Step-by-step instructions for configuring your local development environment for active work on Directorio UDC.

Build docs developers (and LLMs) love