See PostDost in Action

🏠 Beautiful Homepage Clean, modern interface with dark theme	🎨 AI-Generated Posts Culturally-aware content creation
🔍 Explore Ideas Discover trending content themes	🗺️ Location Intelligence Interactive maps for local businesses

📌 Overview

Note

PostDost AI empowers small & local Indian businesses to quickly spin up engaging, culturally-relevant social media post ideas (captions + images). The current version ships with deterministic placeholder generation to keep the project light, demo-friendly, and privacy-safe. Plug in any AI provider later!

Made for India Localized for Indian festivals & culture

Lightning Fast No external API calls needed

Privacy First Your data stays local

Open Source Fork & customize freely

✨ Features

🎯 Core Features Feature Description Status 📝 Smart Captions Multi-caption generation with localized hashtag patterns ✅ Live 🖼️ Image Selection Deterministic pseudo-random selection from curated sources ✅ Live 🗺️ Maps Integration Leaflet + OpenStreetMap with geolocation & mock POIs ✅ Live 🌙 Dark Theme Beautiful dark UI with accessible components ✅ Live 📱 Responsive Works perfectly on all device sizes ✅ Live 🔐 Auth System JWT-based authentication with secure endpoints ✅ Live

🎨 Click to see Feature Highlights

┌──────────────────────────────────────────────────────────────┐
│                    🎯 POST GENERATOR                          │
│                                                               │
│  ┌─────────────────┐    ┌─────────────────┐                  │
│  │  Business Info  │ -> │  AI Processing  │                  │
│  │  • Name         │    │  • Caption Gen  │                  │
│  │  • Category     │    │  • Hashtags     │                  │
│  │  • Location     │    │  • Image Match  │                  │
│  └─────────────────┘    └─────────────────┘                  │
│                                │                              │
│                                ▼                              │
│                    ┌─────────────────┐                       │
│                    │  Ready to Post! │                       │
│                    │  📱 Instagram   │                       │
│                    │  📘 Facebook    │                       │
│                    │  🐦 Twitter     │                       │
│                    └─────────────────┘                       │
└──────────────────────────────────────────────────────────────┘

🛠️ Tech Stack

Next.js 15 App Router	TypeScript 5 Type Safety	Tailwind CSS Styling	React 19 UI Library
shadcn/ui Components	React Hook Form Form Handling	Zod Validation	Leaflet Maps

🧱 Architecture

flowchart LR
    A[👤 User Input] --> B{📋 Zod Validation}
    B --> C[🤖 AI Flow Engine]
    C --> D[📝 Caption Generator]
    C --> E[🖼️ Image Selector]
    D --> F[🎨 Result Renderer]
    E --> F
    F --> G[📱 Copy/Download]
    
    style A fill:#FF6B35,stroke:#FF6B35,color:#fff
    style B fill:#6C63FF,stroke:#6C63FF,color:#fff
    style C fill:#00D4AA,stroke:#00D4AA,color:#fff
    style D fill:#E91E63,stroke:#E91E63,color:#fff
    style E fill:#E91E63,stroke:#E91E63,color:#fff
    style F fill:#FFD700,stroke:#FFD700,color:#000
    style G fill:#138808,stroke:#138808,color:#fff

Loading

📁 Project Structure (Click to expand)

📦 post-dost
├── 📂 src
│   ├── 📂 ai                    # 🤖 AI-related functionality
│   │   ├── generate-gemini-captions.ts
│   │   ├── generate-image-prompt.ts
│   │   └── generate-image-stability.ts
│   │
│   ├── 📂 app                   # 📱 Next.js app router pages
│   │   ├── 📂 api              # 🔌 API routes
│   │   │   ├── 📂 auth        # 🔐 Authentication
│   │   │   └── 📂 generate    # ⚡ Generation endpoints
│   │   ├── 📂 dashboard       # 📊 User dashboard
│   │   ├── 📂 explore         # 🔍 Explore page
│   │   ├── 📂 maps            # 🗺️ Maps feature
│   │   ├── 📂 results         # 📝 Results display
│   │   ├── layout.tsx         # 🎨 Root layout
│   │   └── page.tsx           # 🏠 Homepage
│   │
│   ├── 📂 components           # 🧩 React components
│   │   ├── 📂 ui              # 🎨 shadcn/ui components
│   │   ├── navbar.tsx         # 🔝 Navigation bar
│   │   └── suggestion-cards.tsx
│   │
│   ├── 📂 contexts            # 🔄 React contexts
│   ├── 📂 hooks               # 🪝 Custom hooks
│   └── 📂 lib                 # 🛠️ Utilities
│
├── 📄 package.json
├── 📄 tailwind.config.js
├── 📄 tsconfig.json
└── 📄 README.md               # 📖 You are here!

🚀 Quick Start

⚡ One-Command Setup

🪟 Windows .\setup.bat

🐧 Linux/macOS chmod +x setup.sh && ./setup.sh

📝 Manual Setup

Step-by-step instructions

# 1️⃣ Clone the repository
git clone https://github.com/sanjayrohith/post-dost.git
cd post-dost

# 2️⃣ Install dependencies
npm install --legacy-peer-deps

# 3️⃣ Set up environment variables
cp .env.example .env.local

# 4️⃣ Start development server
npm run dev

# 🎉 Open http://localhost:3000 and enjoy!

⚙️ Environment Configuration

# .env.local
JWT_SECRET=your-super-secret-jwt-key-change-in-production
NEXT_PUBLIC_APP_URL=http://localhost:3000
NODE_ENV=development

# Optional: Add when integrating AI providers
OPENAI_API_KEY=sk-...
GEMINI_API_KEY=...

📜 Available Scripts

Command	Description	Badge
npm run dev	Start development server with hot reload
npm run build	Build optimized production bundle
npm run start	Start production server
npm run lint	Run ESLint for code quality
npm run type-check	Run TypeScript compiler check
npm run clean	Clean install (remove node_modules)

🔧 Troubleshooting

😵 Nothing shows up / Blank page

# Clear cache and reinstall
rm -rf node_modules package-lock.json .next
npm install --legacy-peer-deps
npm run dev

🗺️ Maps not loading

1. Check browser console for errors
2. Ensure you're using a modern browser
3. Try refreshing the page
4. Check if Leaflet CSS is properly loaded

⚠️ React/Leaflet version conflicts

npm install --legacy-peer-deps

👥 Meet the Team

🎯 Sanjay Rohith L Project Lead	💻 Sanjay E Core Developer	🎨 Abishek Raj R R UI/UX Developer
⚡ Sheshakanthra Backend Developer	🔧 Sandeep Kumar S Full Stack Developer	🌟 You? Join the Team!

🛣️ Roadmap

🚀 PostDost Development Roadmap
================================

Q1 2025                    Q2 2025                    Q3 2025
   │                          │                          │
   ▼                          ▼                          ▼
┌──────────────────┐    ┌──────────────────┐    ┌──────────────────┐
│ ✅ Core Features  │    │ 🔄 AI Integration │    │ 🌍 Global Launch  │
│ ✅ Auth System    │    │ 🔄 Multi-language │    │ ⏳ Mobile App     │
│ ✅ Maps Module    │    │ ⏳ Real POI Data  │    │ ⏳ Analytics      │
│ ✅ Dark Theme     │    │ ⏳ Image Gen API  │    │ ⏳ Team Features  │
└──────────────────┘    └──────────────────┘    └──────────────────┘

📋 Detailed Roadmap

• Basic post generation
• JWT Authentication
• Maps integration
• Dark theme UI
• 🔄 Secure HttpOnly cookie-based auth session
• 🔄 Real AI provider integration behind feature flag
• ⏳ Image generation microservice
• ⏳ i18n (Hindi, Tamil, Telugu, Bengali support)
• ⏳ Map POI real data via external API
• ⏳ Accessibility audit (WCAG 2.1 AA)
• ⏳ Automated e2e tests (Playwright)
• ⏳ PWA support for mobile
• ⏳ Analytics dashboard

_{Legend: ✅ Done | 🔄 In Progress | ⏳ Planned}

🤝 Contributing

Step	Action
1️⃣	Fork the repository
2️⃣	Create your feature branch (git checkout -b feature/AmazingFeature)
3️⃣	Commit your changes (git commit -m 'Add some AmazingFeature')
4️⃣	Push to the branch (git push origin feature/AmazingFeature)
5️⃣	Open a Pull Request

Tip

Check out our Contributing Guidelines for more details on how to get started!

📄 License

This project is licensed under the ISC License - see the LICENSE file for details.

💬 Support & Community

🌟 Show your support

If you found this project helpful, please consider giving it a ⭐!

🧪 Development Notes

Important

• Leaflet CSS is intentionally NOT globally imported—only in the maps page
• All AI code is stubbed; swapping providers should only require updating flow functions
• Prefer adding new flows under src/ai/ with a consistent return shape

_{© 2025 PostDost AI. All rights reserved.}