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.

Contact Management App is a full-featured Java Swing desktop application for organizing personal and professional contacts. It combines a clean, modern UI powered by FlatLaf with a well-structured MVC architecture, real-time filtering, multilingual support, and thread-safe concurrent operations that keep the interface responsive at all times.

Get Started

Learn what the app does and how to get it running on your machine.

Quickstart

Build and launch the app in minutes using Maven or the manual compile path.

User Guide

Step-by-step instructions for adding, editing, filtering, and exporting contacts.

Developer Reference

Explore the MVC architecture, data model, and source-level component docs.

Key features

Full CRUD management

Add, update, and delete contacts with name, phone, email, category, and registration date.

Real-time search & filters

Async text search with category filtering — no UI freeze even on large contact lists.

Favorites system

Mark contacts as favorites and instantly see star indicators in the table.

Statistics dashboard

Live bar and pie charts breaking down contacts by category and favorite status.

CSV export

Export visible (filtered) contacts to CSV with thread-safe concurrent execution.

Multilingual UI

Switch between Spanish, English, and Portuguese at runtime without restarting.

Getting started

1

Check prerequisites

Ensure you have Java 17+ and Maven 3.x installed. See Prerequisites for details.
2

Build the application

Run mvn clean package in the project root to compile and package all dependencies.
3

Launch the app

Execute java -cp "out;lib/flatlaf-3.6.jar;..." vista.ventana or use the Maven-packaged JAR.
4

Add your first contact

Fill in name, phone, email, and category in the Contacts tab, then press New or Ctrl+S.
Contacts are stored locally at c:/gestionContactos/datosContactos.csv. The directory is created automatically on first launch.

Build docs developers (and LLMs) love