feat: Implementación de sistema centralizado de metadata en app.properties para facilitar rebranding

- Se creó un archivo `app.properties` que centraliza la metadata de la aplicación, incluyendo nombre, versión, iconos y categorías por plataforma.
- Se implementó la clase `AppConfig` para acceder a la metadata de manera estática y con valores por defecto.
- Se actualizaron las referencias en `Main` y `AppDataDirectory` para utilizar la metadata desde `app.properties`, eliminando constantes hardcodeadas.
- Se modificaron los scripts de empaquetado para leer la metadata y usar iconos según la configuración.
- Se añadió una carpeta para iconos y un README con instrucciones sobre cómo cambiar el nombre y el icono de la aplicación.

Fixes: mejora en la gestión de metadata y simplificación del proceso de rebranding.

Author: edu

Forevernote/src/main/java/com/example/forevernote/AppConfig.java

@@ -0,0 +1,123 @@
+package com.example.forevernote;
+
+import java.io.InputStream;
+import java.util.Properties;
+import java.util.logging.Logger;
+
+/**
+ * Centralized application configuration.
+ * Reads metadata from app.properties file.
+ * 
+ * This allows easy rebranding by modifying a single properties file.
+ */
+public class AppConfig {
+    
+    private static final Logger logger = Logger.getLogger(AppConfig.class.getName());
+    private static Properties properties = null;
+    
+    static {
+        loadProperties();
+    }
+    
+    /**
+     * Loads application properties from app.properties file.
+     */
+    private static void loadProperties() {
+        properties = new Properties();
+        try (InputStream input = AppConfig.class.getClassLoader()
+                .getResourceAsStream("app.properties")) {
+            
+            if (input == null) {
+                logger.warning("app.properties not found, using defaults");
+                // Set defaults
+                properties.setProperty("app.name", "Forevernote");
+                properties.setProperty("app.version", "1.0.0");
+                properties.setProperty("app.vendor", "Forevernote");
+                properties.setProperty("app.description", "A free and open-source note-taking application");
+                properties.setProperty("app.copyright", "Copyright 2025 Forevernote");
+                properties.setProperty("app.window.title", "Forevernote - Free Note Taking");
+                return;
+            }
+            
+            properties.load(input);
+            logger.info("Application properties loaded successfully");
+        } catch (Exception e) {
+            logger.warning("Failed to load app.properties: " + e.getMessage() + ", using defaults");
+            // Set defaults on error
+            properties.setProperty("app.name", "Forevernote");
+            properties.setProperty("app.version", "1.0.0");
+            properties.setProperty("app.vendor", "Forevernote");
+            properties.setProperty("app.description", "A free and open-source note-taking application");
+            properties.setProperty("app.copyright", "Copyright 2025 Forevernote");
+            properties.setProperty("app.window.title", "Forevernote - Free Note Taking");
+        }
+    }
+    
+    /**
+     * Gets a property value, with optional default.
+     */
+    private static String getProperty(String key, String defaultValue) {
+        return properties.getProperty(key, defaultValue);
+    }
+    
+    // Application metadata
+    public static String getAppName() {
+        return getProperty("app.name", "Forevernote");
+    }
+    
+    public static String getAppVersion() {
+        return getProperty("app.version", "1.0.0");
+    }
+    
+    public static String getAppVendor() {
+        return getProperty("app.vendor", "Forevernote");
+    }
+    
+    public static String getAppDescription() {
+        return getProperty("app.description", "A free and open-source note-taking application");
+    }
+    
+    public static String getAppCopyright() {
+        return getProperty("app.copyright", "Copyright 2025 Forevernote");
+    }
+    
+    public static String getWindowTitle() {
+        return getProperty("app.window.title", "Forevernote - Free Note Taking");
+    }
+    
+    // Window icon path (for JavaFX, relative to resources root, e.g., "com/example/forevernote/ui/images/app-icon.png")
+    public static String getWindowIconPath() {
+        return getProperty("app.icon.window", "com/example/forevernote/ui/images/app-icon.png");
+    }
+    
+    // Packaging icon paths (relative to project root)
+    public static String getIconPathWindows() {
+        return getProperty("app.icon.windows", "src/main/resources/icons/app-icon.ico");
+    }
+    
+    public static String getIconPathMacOS() {
+        return getProperty("app.icon.macos", "src/main/resources/icons/app-icon.icns");
+    }
+    
+    public static String getIconPathLinux() {
+        return getProperty("app.icon.linux", "src/main/resources/icons/app-icon.png");
+    }
+    
+    // Package information
+    public static String getPackageName() {
+        return getProperty("app.package.name", "forevernote");
+    }
+    
+    public static String getPackageCategoryWindows() {
+        return getProperty("app.package.category.windows", "Productivity");
+    }
+    
+    public static String getPackageCategoryMacOS() {
+        return getProperty("app.package.category.macos", "public.app-category.productivity");
+    }
+    
+    public static String getPackageCategoryLinux() {
+        return getProperty("app.package.category.linux", "Office");
+    }
+}
+

Forevernote/src/main/java/com/example/forevernote/AppDataDirectory.java

@@ -16,7 +16,6 @@
  */
 public class AppDataDirectory {
 
-    private static final String APP_NAME = "Forevernote";
     private static String baseDir = null;
 
     /**
@@ -69,24 +68,26 @@ private static String getPlatformAppDataDirectory() {
         String home = System.getProperty("user.home");
         File appDataDir;
 
+        String appName = AppConfig.getAppName();
+        
         if (osName.contains("win")) {
-            // Windows: %APPDATA%\Forevernote
+            // Windows: %APPDATA%\AppName
             String appData = System.getenv("APPDATA");
             if (appData != null && !appData.isEmpty()) {
-                appDataDir = new File(appData, APP_NAME);
+                appDataDir = new File(appData, appName);
             } else {
-                appDataDir = new File(home, "AppData\\Roaming\\" + APP_NAME);
+                appDataDir = new File(home, "AppData\\Roaming\\" + appName);
             }
         } else if (osName.contains("mac")) {
-            // macOS: ~/Library/Application Support/Forevernote
-            appDataDir = new File(home, "Library/Application Support/" + APP_NAME);
+            // macOS: ~/Library/Application Support/AppName
+            appDataDir = new File(home, "Library/Application Support/" + appName);
         } else {
-            // Linux: ~/.config/Forevernote (XDG Base Directory)
+            // Linux: ~/.config/AppName (XDG Base Directory)
             String xdgConfig = System.getenv("XDG_CONFIG_HOME");
             if (xdgConfig != null && !xdgConfig.isEmpty()) {
-                appDataDir = new File(xdgConfig, APP_NAME);
+                appDataDir = new File(xdgConfig, appName);
             } else {
-                appDataDir = new File(home, ".config/" + APP_NAME);
+                appDataDir = new File(home, ".config/" + appName);
             }
         }
 

Forevernote/src/main/java/com/example/forevernote/Main.java

@@ -43,11 +43,12 @@ public void start(Stage primaryStage) {
                 scene.getStylesheets().add(cssResource.toExternalForm());
             }
 
-            primaryStage.setTitle("Forevernote - Free Note Taking");
+            primaryStage.setTitle(AppConfig.getWindowTitle());
 
+            // Load window icon from app.properties
             try {
-                var iconStream = getClass().getResourceAsStream(
-                    "/com/example/forevernote/ui/images/app-icon.png");
+                String iconPath = "/" + AppConfig.getWindowIconPath();
+                var iconStream = getClass().getResourceAsStream(iconPath);
                 if (iconStream != null) {
                     primaryStage.getIcons().add(new Image(iconStream));
                 }

Forevernote/src/main/resources/app.properties

@@ -0,0 +1,30 @@
+# Application Metadata
+# This file centralizes all application metadata for easy customization
+# Modify these values to rebrand the application
+
+# Application Information
+app.name=Forevernote
+app.version=1.0.0
+app.vendor=Forevernote
+app.description=A free and open-source note-taking application
+app.copyright=Copyright 2025 Forevernote
+
+# Application Window Title
+app.window.title=Forevernote - Free Note Taking
+
+# Icon Paths
+# Window icon (for JavaFX window, PNG format, relative to resources root)
+app.icon.window=com/example/forevernote/ui/images/app-icon.png
+
+# Packaging icons (relative to project root)
+# All icon formats are ready: icon.ico (Windows), icon.icns (macOS), icon.png (Linux)
+app.icon.windows=src/main/resources/icons/icon.ico
+app.icon.macos=src/main/resources/icons/icon.icns
+app.icon.linux=src/main/resources/icons/icon.png
+
+# Package Information
+app.package.name=forevernote
+app.package.category.windows=Productivity
+app.package.category.macos=public.app-category.productivity
+app.package.category.linux=Office
+

Forevernote/src/main/resources/com/example/forevernote/ui/images/app-icon.png

@@ -0,0 +1,34 @@
+# Application Icons
+
+Place your application icons here in the following formats:
+
+- **Windows**: `app-icon.ico` (multiple sizes: 16x16, 32x32, 48x48, 256x256)
+- **macOS**: `app-icon.icns` (Apple icon format)
+- **Linux**: `app-icon.png` (128x128 or 256x256 recommended)
+
+## Icon Requirements
+
+### Windows (.ico)
+- Format: ICO file with multiple embedded sizes
+- Recommended sizes: 16x16, 32x32, 48x48, 256x256
+- Tools: Use online converters or tools like GIMP, ImageMagick
+
+### macOS (.icns)
+- Format: ICNS (Apple Icon Image format)
+- Recommended sizes: 16x16, 32x32, 128x128, 256x256, 512x512, 1024x1024
+- Tools: Use `iconutil` on macOS or online converters
+
+### Linux (.png)
+- Format: PNG with transparency
+- Recommended size: 128x128 or 256x256
+- Tools: Any image editor (GIMP, Photoshop, etc.)
+
+## Configuration
+
+Icon paths are configured in `src/main/resources/app.properties`:
+- `app.icon.windows=src/main/resources/icons/app-icon.ico`
+- `app.icon.macos=src/main/resources/icons/app-icon.icns`
+- `app.icon.linux=src/main/resources/icons/app-icon.png`
+
+If icons are not found, the packaging scripts will skip the `--icon` parameter (application will still work, just without custom icon).
+