This guide walks you through every step needed to get a local instance of Directorio UDC running on your machine. By the end you will have the Express backend process started and the Vite development server hosting the React frontend.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.
Prerequisites — make sure the following are installed before you begin:
- Node.js 18 or later — nodejs.org
- npm 9 or later — bundled with Node.js 18+
- Git — git-scm.com
Install Backend Dependencies
Navigate to the This installs the three production packages the API server needs: Express 5 (
BACKEND directory and install its dependencies:^5.2.1), cors (^2.8.6), and path (^0.12.7).Install Frontend Dependencies
Move to the This installs React 19 (
FRONTEND directory and install its dependencies:^19.2.5) and react-dom, Vite 8 (^8.0.10), TypeScript (~6.0.2), plus all supporting tooling including @vitejs/plugin-react, the React Compiler Babel preset, ESLint (^10.2.1), and the corresponding type definitions.Start the Backend Server
Return to the Keep this terminal open while you work on the frontend. The backend package defines no custom
BACKEND directory and start the Express server:dev or start script, so node index.js is used directly.Start the Frontend Dev Server
Open a new terminal, navigate to the Vite starts a development server with Hot Module Replacement (HMR) enabled, so changes to any source file are reflected in the browser instantly without a full page reload. The dev server is available at http://localhost:5173 by default.
FRONTEND directory, and run:Open the App in Your Browser
With both servers running, open your browser and navigate to:http://localhost:5173Because Directorio UDC is currently a scaffold, you will see the default Vite + React starter template — the counter button and framework logos that ship with a new Vite project. Feature development is ongoing; refer to the Architecture Overview to understand how to extend the app.
Available Frontend Scripts
All scripts are run from theFRONTEND directory with npm run <command>.
| Command | Description |
|---|---|
npm run dev | Start development server with HMR |
npm run build | Build for production (TypeScript compile + Vite bundle) |
npm run preview | Preview the production build locally |
npm run lint | Run ESLint on TypeScript/TSX files |
Next Steps
Architecture Overview
Understand how the React frontend and Express backend fit together, how data flows between them, and where to extend each layer.
Development Guide
Configure your local environment for active development, including environment variables, editor setup, and debugging tips.