Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/JuanSebax85/frontend-prueba-fullstack/llms.txt

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

The fastest way to explore Sistema de Gestión is to run it directly with the Node.js development server. This approach gives you hot-reloading and browser devtools without needing to build a Docker image first. You will need the backend service running before the frontend can fetch or persist any data.
The frontend is a pure client-side application — it has no server of its own. All data comes from a separate backend API. Make sure your backend is running and reachable before starting the frontend, otherwise all list views will show empty or error states.

​
Prerequisites

Before you start, make sure you have the following installed:
  • Node.js 20 or later (node -v to check)
  • npm (bundled with Node.js)
  • The backend API running and accessible at a known URL

​
Steps

1

Clone the repository

Download the project source code to your local machine.
git clone https://github.com/JuanSebax85/frontend-prueba-fullstack.git
cd frontend-prueba-fullstack
2

Configure the API URL

The app reads the backend URL from the REACT_APP_API_URL environment variable at build time and dev-server startup. Create a .env file in the project root:
REACT_APP_API_URL=http://localhost:8080
Replace http://localhost:8080 with the actual URL where your backend is running. The Axios instance in src/services/api.js uses this value as the baseURL for every request.
Variable names must start with REACT_APP_ to be embedded by react-scripts. Any other prefix is silently ignored at build time.
3

Install dependencies

Install all npm packages declared in package.json.
npm install
Key runtime dependencies installed:
PackageVersionPurpose
react^19.2.5UI framework
react-dom^19.2.5DOM renderer
axios^1.15.2HTTP client
react-scripts5.0.1Build toolchain
4

Start the development server

Launch the Create React App dev server with hot-reloading enabled.
npm start
The server starts on port 3000 by default and opens your browser automatically. If port 3000 is already in use, react-scripts will prompt you to use the next available port.
5

Open the application

Navigate to the app in your browser:
http://localhost:3000
You should see the Sistema de Gestión heading and a navigation menu with three buttons: Alumnos, Materias, and Notas.

​
Available scripts

These scripts are defined in package.json and can be run from the project root. 
npm start        # Start the development server (hot-reload on port 3000)
npm run build    # Compile a production-optimised build to the /build directory
npm test         # Run the test suite with react-scripts test (Jest + Testing Library)
The npm run build output is what the Docker image serves via Nginx. See Docker deployment for details on building and running the container.

Build docs developers (and LLMs) love

Get started for freeTalk to us