Skip to content

sathwikhbhat/scm

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

90 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Smart Contact Manager (SCM)

A modern, privacy-first web application that redefines how you manage your contacts.
Built with enterprise-grade technologies, SCM offers secure, intelligent, and seamless contact management—accessible anywhere, anytime.

Screenshots

Landing Page - Dark Theme Landing Page - Light Theme

Key Features

Security & Privacy First

  • End-to-end encryption for sensitive contact data
  • Multi-factor authentication with OAuth integration
  • Email verification for secure account creation
  • Spring Security implementation with role-based access

Intelligent Contact Management

  • Smart contact organisation with tags and categories
  • Advanced search & filtering with instant results
  • Bulk operations for managing multiple contacts
  • Export functionality for data portability

Tech Stack

Layer Technology Purpose
Backend Spring Boot 3.x REST API & Business Logic
Frontend Thymeleaf + Tailwind CSS Server-side rendering & Styling
Database MySQL 8.0+ Data persistence & relationships
Security Spring Security 6.x Authentication & Authorization
Cloud Cloudinary File storage
Authentication OAuth 2.0 Social login integration
Build Tool Maven Dependency management

Quick Start

Prerequisites

Ensure you have the following installed:

  • Java 21+ (OpenJDK recommended)
  • Maven 3.8+
  • MySQL 8.0+
  • Git

Installation

  1. Clone the repository

    git clone https://github.com/sathwikhbhat/scm.git
    cd scm
  2. Set up the database

  3. Configure the application properties

  4. Build and run

    ./mvnw clean install
    ./mvnw spring-boot:run
  5. Access the application Open http://localhost:8080 in your browser

Usage Guide

Getting Started

  1. Create Account: Sign up with email or use OAuth (Google/GitHub)
  2. Verify Email: Check your inbox and verify your account
  3. Complete Profile: Add your profile picture and personal details

Managing Contacts

  • Add Contact: Click the "+" button and fill in contact details
  • Edit Contact: Click on any contact card to edit information
  • Search Contacts: Use the search bar with filters for quick access
  • Export: Download your contacts in various formats (CSV, vCard)

Contributing

Here's how you can help me:

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add amazing feature'
  4. Push to the branch: git push origin feature/amazing-feature
  5. Open a Pull Request

Reporting Issues

Found a bug? Have a feature request? Create a new issue here


⭐ Star this repository if it helped you! ⭐

Built with ❤️ by Sathwik Hejamady Bhat

About

Smart Contact Manager

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published