{"id":21700023,"url":"https://github.com/anandpiyush1521/smartcontactmanager","last_synced_at":"2026-02-26T03:59:29.223Z","repository":{"id":237052185,"uuid":"793703181","full_name":"anandpiyush1521/SmartContactManager","owner":"anandpiyush1521","description":"A sophisticated web application designed to streamline contact management, offering robust features such as email verification, seamless OAuth integration for secure logins, and efficient image uploads powered by Cloudinary.","archived":false,"fork":false,"pushed_at":"2025-03-01T19:17:44.000Z","size":3232,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-01T03:51:14.546Z","etag":null,"topics":["cloudinary","hibernate","java","oauth","spring-boot","spring-security","spring-validation","sql","tailwind"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/anandpiyush1521.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-04-29T17:56:29.000Z","updated_at":"2025-03-01T19:17:47.000Z","dependencies_parsed_at":"2024-05-08T17:12:31.769Z","dependency_job_id":"a8607ac0-e0e4-49af-89f3-7759863908c0","html_url":"https://github.com/anandpiyush1521/SmartContactManager","commit_stats":null,"previous_names":["anandpiyush1521/smartcontactmanager"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anandpiyush1521%2FSmartContactManager","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anandpiyush1521%2FSmartContactManager/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anandpiyush1521%2FSmartContactManager/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anandpiyush1521%2FSmartContactManager/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anandpiyush1521","download_url":"https://codeload.github.com/anandpiyush1521/SmartContactManager/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253828629,"owners_count":21970746,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cloudinary","hibernate","java","oauth","spring-boot","spring-security","spring-validation","sql","tailwind"],"created_at":"2024-11-25T20:12:29.694Z","updated_at":"2026-02-26T03:59:24.191Z","avatar_url":"https://github.com/anandpiyush1521.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Smart Contact Manager\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Powered_by-Spring_Boot-blue?style=for-the-badge\u0026logo=spring\" alt=\"Powered by Spring Boot\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Powered_by-Cloudinary-green?style=for-the-badge\u0026logo=cloudinary\" alt=\"Powered by Cloudinary\"\u003e\n  \u003cimg src=\"https://img.shields.io/badge/Database-MySQL-blue?style=for-the-badge\u0026logo=mysql\" alt=\"Powered by MySQL\"\u003e\n\n\u003c/p\u003e\n\nWelcome to **Smart Contact Manager**, a dynamic web application designed to help users manage their contacts with ease. With seamless authentication options, the ability to store contact images in the cloud, and a modern UI, Smart Contact Manager ensures a smooth user experience.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"demoss/home.png\" width=\"1000\" alt=\"Smart Contact Manager Preview\"\u003e\n\u003c/p\u003e\n\n## Table of Contents\n\n- [Features](#features)\n- [Technologies Used](#technologies-used)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n\n## Features\n\n- **User Registration and Authentication**:\n    - Email verification for new users.\n    - OAuth login via Google and GitHub.\n    - Direct email login support.\n\n- **Contact Management**:\n    - Add, edit, and delete contacts with details such as name, email, phone number, and profile image.\n    - Cloud-based image storage using Cloudinary.\n\n- **Search Functionality**:\n    - Advanced search by name, email, or phone number.\n\n- **Responsive User Interface**:\n    - Display contacts in an easy-to-view modal format.\n    - Fully responsive design for optimal user experience on mobile, tablet, and desktop devices.\n\n## Technologies Used\n\n- **Backend**: Spring Boot, Spring Security, JPA/Hibernate, OAuth2\n- **Frontend**: Thymeleaf, Tailwind CSS, React.js\n- **Database**: MySQL\n- **Authentication**: JWT, OAuth (Google and GitHub)\n- **Image Storage**: Cloudinary\n- **Email Service**: Spring Email\n- **Logging**: SLF4J\n\n## Installation\n\n### Prerequisites\n\n- Node.js\n- npm\n- Java JDK\n- Maven\n- MySQL\n\n### Backend Setup\n\n1. **Clone the repository**:\n    ```bash\n    git clone https://github.com/your-username/smart-contact-manager.git\n    cd smart-contact-manager\n    ```\n\n2. **Configure MySQL database**:\n    ```bash\n    CREATE DATABASE smart_contact_manager;\n    ```\n\n3. **Update application.yml** with your MySQL credentials and other environment variables:\n    ```yaml\n    spring.datasource.url=jdbc:mysql://localhost:3306/smart_contact_manager\n    spring.datasource.username=your_mysql_username\n    spring.datasource.password=your_mysql_password\n    spring.jpa.hibernate.ddl-auto=update\n    spring.jpa.show-sql=true\n    spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5Dialect\n    spring.security.oauth2.client.registration.google.clientname=your_google_client_name\n    cloudinary:\n      cloud_name=your_cloud_name\n      api_key=your_api_key\n      api_secret=your_api_secret\n    ```\n\n4. **Run the Spring Boot application**:\n    ```bash\n    mvn spring-boot:run\n    ```\n\n### Frontend Setup\n\n1. **Navigate to the client directory**:\n    ```bash\n    cd client\n    ```\n\n2. **Install dependencies**:\n    ```bash\n    npm install\n    ```\n\n3. **Start the React.js application**:\n    ```bash\n    npm start\n    ```\n\n### Usage\n\n1. **Access the Application**: Open your browser and navigate to [http://localhost:3000](http://localhost:3000).\n2. **Register or Login**: Create an account via email verification or log in using Google/GitHub.\n3. **Manage Contacts**: Add, edit, and delete contacts. Search for contacts by name, email, or phone.\n4. **Image Uploads**: Upload contact images, which are stored in Cloudinary.\n\n## Contributing\n\nWe welcome contributions to the Smart Contact Manager project! Follow these steps to contribute:\n\n1. **Fork the repository**.\n2. **Create a new branch**:\n    ```bash\n    git checkout -b feature/your-feature\n    ```\n3. **Commit your changes**:\n    ```bash\n    git commit -m 'Add new feature'\n    ```\n4. **Push to the branch**:\n    ```bash\n    git push origin feature/your-feature\n    ```\n5. **Create a pull request** and we’ll review your changes.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n\n## Contact\n\nFor any inquiries or feedback, please contact us at:\n\n- **Email**: piyushanand2580@gmail.com\n- **GitHub**: [Piyush Singh](https://github.com/anandpiyush1521)\n\n---\n\nThank you for using **Smart Contact Manager**! We hope you enjoy managing your contacts with ease.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanandpiyush1521%2Fsmartcontactmanager","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanandpiyush1521%2Fsmartcontactmanager","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanandpiyush1521%2Fsmartcontactmanager/lists"}