diff --git a/.DS_Store b/.DS_Store
new file mode 100644
index 0000000..4615eda
Binary files /dev/null and b/.DS_Store differ
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..9af82e0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,56 @@
+# Gestor de Palavra-Passes
+
+O Gestor de Palavra-Passes é uma aplicação desenvolvida em Java com o objetivo de guardar, listar, procurar e apagar contas de forma simples através da consola.
+
+O projeto foi criado utilizando Apache NetBeans e Maven, permitindo uma estrutura organizada e fácil de executar em diferentes sistemas.
+
+## Funcionalidades
+
+* Criar contas
+* Guardar aplicação/site, email/utilizador e palavra-passe
+* Listar todas as contas guardadas
+* Procurar contas rapidamente
+* Apagar contas existentes
+* Gerar palavras-passe aleatórias seguras
+* Armazenamento local em ficheiro `.txt`
+
+## Como Funciona
+
+As contas são guardadas num ficheiro chamado `data.txt`.
+
+Cada linha contém:
+Aplicação/Site ; Nome/Email ; Palavra-Passe
+
+Exemplo:
+Netflix;[utilizador@email.com](mailto:utilizador@email.com);MinhaPassword123
+
+O programa utiliza:
+
+* `Scanner` para interação com o utilizador
+* `BufferedWriter` para guardar dados
+* `BufferedReader` para ler dados
+* Estruturas de repetição e menus interativos
+
+## Estrutura do Projeto
+
+* `GestorPalavraPasses.java` → Classe principal
+* `Menu` → Interface de menu da aplicação
+* `Account` → Estrutura das contas
+* `FileManager` → Gestão de ficheiros
+* `PasswordGenerator` → Geração de passwords seguras
+
+## Tecnologias Utilizadas
+
+* Java
+* Apache NetBeans
+* Maven
+
+## Objetivo
+
+Este projeto foi desenvolvido com fins educativos para praticar:
+
+* Programação orientada a objetos
+* Manipulação de ficheiros
+* Menus interativos
+* Organização de projetos Java
+* Gestão de dados locais
diff --git a/src/.DS_Store b/src/.DS_Store
new file mode 100644
index 0000000..18e418f
Binary files /dev/null and b/src/.DS_Store differ
diff --git a/src/main/.DS_Store b/src/main/.DS_Store
new file mode 100644
index 0000000..aa7db5b
Binary files /dev/null and b/src/main/.DS_Store differ
diff --git a/src/main/java/.DS_Store b/src/main/java/.DS_Store
new file mode 100644
index 0000000..36d3daf
Binary files /dev/null and b/src/main/java/.DS_Store differ
diff --git a/src/main/java/com/.DS_Store b/src/main/java/com/.DS_Store
new file mode 100644
index 0000000..90248ba
Binary files /dev/null and b/src/main/java/com/.DS_Store differ
diff --git a/src/main/java/com/mycompany/.DS_Store b/src/main/java/com/mycompany/.DS_Store
new file mode 100644
index 0000000..ab8ebbc
Binary files /dev/null and b/src/main/java/com/mycompany/.DS_Store differ