# NPSKit

NPSKit is a modern SaaS platform designed to collect and manage Net Promoter Score (NPS) feedback. Its core feature is the ability to instantly generate custom-branded surveys from Google Maps Business URLs, including AI-generated isometric branding graphics.

## Core Features

- **Google Maps Integration**: Automatically extract business details (name, type, brand colors) from any Google Maps URL.
- **AI-Powered Graphics**: Automatic generation of 3D isometric diorama-style scene images matching the business context via Google Gemini.
- **Omnichannel Survey Delivery**: Share surveys via direct links, QR codes, email, or SMS.
- **Real-time Analytics**: Comprehensive dashboard for businesses to track NPS scores, trends, and individual responses.
- **Blog System**: Full-featured blog for content marketing with AI image generation and rich text editing.

## Technical Architecture

- **Frontend**: React 18, TypeScript, Vite, Tailwind CSS v4, shadcn/ui.
- **Backend**: Node.js, Express.js, TypeScript.
- **Database**: PostgreSQL with Drizzle ORM.
- **AI**: Google Gemini (GenAI SDK) for info extraction and image generation.
- **Payments**: Stripe integration for SaaS subscriptions.
- **Authentication**: Google OAuth and email/password auth.

## Key Endpoints

- `POST /api/surveys/generate`: Generate a survey from a Google Maps URL.
- `GET /api/surveys/slug/:slug`: Fetch a survey by its unique slug.
- `POST /api/responses`: Submit a survey response.
- `GET /api/blog/posts`: List published blog posts.
- `GET /api/staff/me`: Current authenticated administrator status.

## Target Audience

Businesses and local establishments looking to monitor customer satisfaction and act on feedback with zero-setup branded surveys.