Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/efrain-svg/Potes_Freddy_ProgInterfacesG_U3/llms.txt

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

This page walks you through building Contact Management App from source and launching it for the first time. You have two options: the recommended Maven build, or a manual compile using the bundled library JARs.

Prerequisites

Before you begin, make sure you have: Verify your Java version:
java -version
You should see output like openjdk version "17.x.x" or later. Maven downloads FlatLaf automatically and packages everything into a single JAR.
1

Clone the repository

git clone https://github.com/efrain-svg/Potes_Freddy_ProgInterfacesG_U3.git
Set-Location Potes_Freddy_ProgInterfacesG_U3
2

Build the project

mvn clean package
Maven compiles all source files under src/ and packages them with the FlatLaf dependency.
3

Run the application

java -jar target/u1c5-agc-1.0.0.jar
The main window opens immediately. Contacts are stored at c:\gestionContactos\datosContactos.csv.

Option 2: Manual compile

Use this path if Maven is not available. The required JARs are bundled in the lib/ directory.
1

Create the output directory

New-Item -ItemType Directory -Path .\out -Force
2

Compile all source files

javac -cp ".\lib\flatlaf-3.6.jar;.\lib\flatlaf-extras-3.6.jar;.\lib\jsvg-1.4.0.jar" `
  -d .\out `
  .\src\modelo\*.java `
  .\src\controlador\*.java `
  .\src\vista\*.java `
  .\src\vista\charts\*.java `
  .\src\vista\i18n\*.java `
  .\src\vista\theme\*.java
3

Launch the application

java -cp ".\out;.\lib\flatlaf-3.6.jar;.\lib\flatlaf-extras-3.6.jar;.\lib\jsvg-1.4.0.jar" vista.ventana

First launch

When the app opens for the first time:
  1. The c:\gestionContactos\ directory is created automatically.
  2. An empty datosContactos.csv file is initialized with the header row.
  3. The UI loads in Spanish by default. Change the language using the Language dropdown in the top-right corner of the Contacts tab.
The data file path is hardcoded to c:/gestionContactos/datosContactos.csv. Make sure the application has write permissions to the C: drive root.

Add your first contact

1

Fill in the form

Enter a name, phone number, and email address in the top form fields. Select a category (Family, Friends, or Work) from the dropdown.
2

Save the contact

Click New or press Ctrl+S. The contact appears immediately in the table below.
3

Verify persistence

Close and reopen the app. Your contact loads automatically from the CSV file.
Use Ctrl+F to jump directly to the search box and filter your contacts by name, phone, or email.

Build docs developers (and LLMs) love