Couplehashtag - Couple Name Hashtag Maker

Generate creative and unique couple name hashtags for weddings, engagements, and love stories! Perfect for Instagram, WhatsApp, and all social media platforms.

🌟 Features

• Smart Hashtag Generation: Creates 30+ unique hashtag variations from two names
• Multiple Algorithms:
  • Simple concatenation (e.g., #RanjeetDeepa)
  • Creative combinations (e.g., #RanDee)
  • Modifier additions (e.g., #RanjeetDeepaLove, #ForeverRanjeet)
• One-Click Copy: Easily copy hashtags to clipboard
• Social Sharing: Share directly to Instagram, WhatsApp, Twitter/X, and Arattai
• Responsive Design: Works perfectly on mobile, tablet, and desktop
• PWA Support: Install as a mobile app on your device
• Beautiful UI: Modern design with smooth animations using Framer Motion
• Trending Analytics: Track popular hashtags (backend feature)

🏗️ Architecture

Frontend Layer

• React.js - Modern, component-based UI
• Bootstrap 5 - Responsive design framework
• Framer Motion - Smooth animations and interactions
• PWA - Progressive Web App for mobile installation

Backend Layer

• Node.js + Express.js - Lightweight API server
• REST API - Clean endpoint design
• In-Memory Storage - Trending analytics (can be upgraded to MongoDB/Firebase)

Core Algorithm

• Name concatenation and creative combinations
• Multiple variation generation
• Modifier-based hashtag creation

📦 Installation & Setup

For detailed step-by-step installation instructions, see INSTALLATION.md

Quick Start

Prerequisites

• Node.js (v14 or higher)
• npm (v6 or higher)

Using the Start Script (Linux/Mac)

git clone https://github.com/wdranjeet/Couplehashtag.git
cd Couplehashtag
chmod +x start.sh
./start.sh

Manual Installation (All Platforms)

Backend Setup:

cd backend
npm install
npm start

The backend API will run on http://localhost:5000

Frontend Setup:

cd frontend
npm install
npm start

The frontend will run on http://localhost:3000

Deploy to Netlify (No Backend Required)

1. Fork/clone this repository
2. Connect to Netlify
3. Set build settings:
   • Base directory: frontend
   • Build command: npm run build
   • Publish directory: frontend/build
4. Deploy!

The _redirects file and netlify.toml configuration are already included to prevent "broken link" errors.

🚀 Usage

Running the Application

1. Start the backend server (in the backend directory):

npm start

2. In a new terminal, start the frontend (in the frontend directory):

npm start

3. Open your browser and navigate to http://localhost:3000

4. Enter two names and click "Generate Hashtags"

5. Copy your favorite hashtags or share them directly to social media!

📡 API Endpoints

POST /api/generateHashtags

Generate hashtags from two names.

Request:

{
  "name1": "Ranjeet",
  "name2": "Deepa"
}

Response:

{
  "success": true,
  "hashtags": [
    "#RanjeetDeepa",
    "#DeepaRanjeet",
    "#RanjeetDeepeLove",
    ...
  ],
  "count": 30
}

GET /api/trending

Get the most popular hashtags.

Response:

{
  "success": true,
  "trending": [
    {"hashtag": "#RanjeetDeepa", "count": 5},
    {"hashtag": "#DeepaRanjeet", "count": 3}
  ],
  "count": 10
}

🏗️ Building for Production

Frontend Build

cd frontend
npm run build

This creates a build folder with optimized production files.

Backend Production

The backend is production-ready. For deployment:

1. Set environment variables (PORT, etc.)
2. Use a process manager like PM2
3. Set up a reverse proxy (nginx)

📱 PWA Installation

The app can be installed as a Progressive Web App on mobile devices:

1. Open the app in your mobile browser
2. Look for the "Add to Home Screen" prompt
3. Install and use like a native app!

🎨 Customization

Modify Hashtag Modifiers

Edit backend/src/hashtagGenerator.js to add new creative modifiers:

this.modifiers = [
  'Love', 'Forever', 'Together', 'CoupleGoals',
  // Add your custom modifiers here
];

Change Theme Colors

Edit frontend/src/App.css and frontend/src/components/HashtagGenerator.css

🔮 Future Enhancements

• AI-powered hashtag generation using OpenAI/HuggingFace
• MongoDB/Firebase integration for persistent analytics
• User accounts and favorites
• Hashtag popularity voting
• More social platform integrations
• Multi-language support
• Custom hashtag templates

📄 License

This project is licensed under the GNU General Public License v2.0 - see the LICENSE file for details.

🤝 Contributing

Contributions are welcome! Feel free to:

• Report bugs
• Suggest new features
• Submit pull requests

💖 Made with Love

Created for couples everywhere to celebrate their love stories!