Skip to content

steadycalls/gbp-quick-rank-kit

Repository files navigation

GBP Quick-Rank Kit

Get your local business on the map, fast. Your AI-powered Google Business Profile optimization kit for just $49.

GBP Quick-Rank Kit License

Overview

GBP Quick-Rank Kit is a full-stack web application that delivers professional Google Business Profile optimization services through AI automation. For a one-time fee of $49, local business owners receive a comprehensive optimization kit worth over $500, including:

  • 🎯 AI-Powered GBP Audit - Complete profile analysis with actionable recommendations
  • 🌐 SEO-Optimized Website - Ready-to-deploy single-page website with schema markup
  • 📋 Implementation Guide - Step-by-step instructions for GBP optimization and website deployment

Value Proposition

Service Component Professional Cost GBP Quick-Rank Kit
GBP Audit & Optimization $300-$500 ✅ Included
SEO Content for Webpage $100-$300 ✅ Included
Simple Web Page Design $200-$500 ✅ Included
Local SEO Strategy $150/hour ✅ Included
Total Value $600-$1,450+ $49

Features

🚀 Core Functionality

  • Professional Landing Page - Marketing page with clear value proposition and conversion-optimized design
  • Secure Authentication - Manus OAuth integration for user management
  • Simple Purchase Flow - Streamlined form collecting essential business information
  • AI Kit Generation - Automated generation using GPT-4 (2-3 minutes)
  • User Dashboard - View all purchases with real-time status tracking
  • Comprehensive Kit Viewer - Tabbed interface for audit, website, guide, and downloads
  • Mobile-Responsive - Fully responsive design across all devices

🤖 AI-Generated Deliverables

1. GBP Audit & Action Plan

  • Completeness score (0-100)
  • Category optimization recommendations
  • Keyword-optimized business description (750 characters)
  • Photo & video strategy checklist
  • Review generation plan with templates
  • Q&A recommendations (10 industry-specific questions)

2. SEO-Optimized Website

  • Complete HTML page with embedded CSS
  • Mobile-first, responsive design
  • Hero, services, about, and contact sections
  • JSON-LD LocalBusiness schema markup
  • Plain text content for easy editing

3. Implementation Guide

  • Step-by-step GBP optimization instructions
  • Website deployment guides (Netlify, GitHub Pages)
  • GBP-to-website linking process
  • Ongoing maintenance tasks (weekly, monthly)

Tech Stack

Frontend

  • React 19 with TypeScript
  • Tailwind CSS 4 for styling
  • Wouter for routing
  • shadcn/ui component library
  • tRPC React Query for type-safe API calls

Backend

  • Express 4 server
  • tRPC 11 for end-to-end type safety
  • Drizzle ORM with MySQL/TiDB database
  • Manus OAuth for authentication
  • OpenAI GPT-4 for AI generation

Infrastructure

  • Node.js 22.13.0
  • pnpm package manager
  • TypeScript for type safety
  • Vite for fast development and builds

Getting Started

Prerequisites

  • Node.js 22.13.0 or higher
  • pnpm package manager
  • MySQL/TiDB database
  • OpenAI API key (provided via Manus platform)

Installation

  1. Clone the repository

    git clone https://github.com/steadycalls/gbp-quick-rank-kit.git
    cd gbp-quick-rank-kit
  2. Install dependencies

    pnpm install
  3. Set up environment variables

    The following environment variables are automatically provided by the Manus platform:

    • DATABASE_URL - MySQL/TiDB connection string
    • JWT_SECRET - Session cookie signing secret
    • VITE_APP_ID - Manus OAuth application ID
    • OAUTH_SERVER_URL - Manus OAuth backend URL
    • VITE_OAUTH_PORTAL_URL - Manus login portal URL
    • OWNER_OPEN_ID, OWNER_NAME - Owner information
    • VITE_APP_TITLE - Application title
    • VITE_APP_LOGO - Logo image URL
    • BUILT_IN_FORGE_API_URL - Manus built-in APIs URL
    • BUILT_IN_FORGE_API_KEY - API key for Manus services
  4. Initialize the database

    pnpm db:push
  5. Start the development server

    pnpm dev
  6. Open your browser

    Navigate to http://localhost:3000

Project Structure

gbp-quick-rank-kit/
├── client/                    # Frontend React application
│   ├── public/               # Static assets
│   ├── src/
│   │   ├── pages/           # Page components
│   │   │   ├── Home.tsx     # Landing page
│   │   │   ├── Purchase.tsx # Purchase flow
│   │   │   ├── Dashboard.tsx # User dashboard
│   │   │   └── KitView.tsx  # Kit viewer
│   │   ├── components/      # Reusable UI components
│   │   ├── contexts/        # React contexts
│   │   ├── hooks/           # Custom hooks
│   │   ├── lib/             # Utilities and tRPC client
│   │   ├── App.tsx          # Routes and layout
│   │   └── main.tsx         # Entry point
├── server/                   # Backend Express application
│   ├── _core/               # Framework core (OAuth, context, etc.)
│   ├── services/            # Business logic
│   │   └── kitGenerator.ts  # AI kit generation service
│   ├── db.ts                # Database queries
│   └── routers.ts           # tRPC API routes
├── drizzle/                 # Database schema and migrations
│   └── schema.ts            # Table definitions
├── shared/                  # Shared constants and types
└── storage/                 # S3 storage helpers

Database Schema

Users Table

  • Standard authentication fields (openId, name, email, role)
  • Timestamps for tracking

Purchases Table

  • User reference
  • Business information (name, address, phone, website)
  • Status tracking (pending, processing, completed, failed)
  • Payment information
  • Timestamps

Generated Kits Table

  • Purchase reference
  • GBP audit results (completeness score, recommendations, strategies)
  • Website content (HTML, content, schema markup)
  • Implementation guide
  • Timestamps

API Endpoints

All API endpoints are type-safe and accessible via tRPC:

Authentication

  • auth.me - Get current user
  • auth.logout - Log out user

Kit Management

  • kit.createPurchase - Create new purchase
  • kit.generateKit - Generate AI kit for purchase
  • kit.myPurchases - Get user's purchases
  • kit.getKit - Get specific kit by purchase ID

Development

Available Scripts

pnpm dev          # Start development server
pnpm build        # Build for production
pnpm db:push      # Push database schema changes
pnpm lint         # Run linter
pnpm type-check   # Run TypeScript type checking

Adding New Features

  1. Update database schema in drizzle/schema.ts
  2. Push schema changes with pnpm db:push
  3. Add database helpers in server/db.ts
  4. Create tRPC procedures in server/routers.ts
  5. Build UI components in client/src/pages/
  6. Register routes in client/src/App.tsx

AI Generation Pipeline

The kit generation process uses structured prompts and JSON schema validation:

Step 1: GBP Audit Generation

  • Analyzes business information
  • Generates completeness score and recommendations
  • Creates optimized description and strategies

Step 2: Website Content Generation

  • Creates complete HTML page with responsive design
  • Generates SEO-optimized content
  • Embeds JSON-LD schema markup

Step 3: Implementation Guide Generation

  • Provides step-by-step instructions
  • Includes deployment guides
  • Outlines maintenance tasks

All AI responses use strict JSON schema validation for reliability.

Deployment

This application is designed to be deployed on the Manus platform, which provides:

  • Automatic environment variable injection
  • Built-in OAuth authentication
  • Database provisioning
  • AI API access
  • S3 storage integration

To deploy:

  1. Create a checkpoint in the Manus platform
  2. Click the "Publish" button in the Management UI
  3. Your application will be live with a custom domain

Contributing

Contributions are welcome! Please follow these steps:

  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

License

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

Acknowledgments

  • Built with Manus - AI-powered development platform
  • UI components from shadcn/ui
  • AI generation powered by OpenAI GPT-4
  • Research based on industry best practices from Tim Stoddart, CMO Eugene, Ippei, and Diggity Marketing

Support

For questions, issues, or feature requests:

Roadmap

  • Payment integration (Stripe)
  • Email delivery of kits
  • Additional AI models support
  • Multi-language support
  • Advanced analytics dashboard
  • White-label options

Made with ❤️ using AI-powered development

About

AI-powered Google Business Profile optimization kit delivering 00+ worth of services for 9

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors