Skip to content

Jorstors/PageSense

Repository files navigation

Pagesense Logo

An intelligent website auditing platform with user dashboard

Pagesense is an AI-powered website auditing platform that analyzes landing pages and provides actionable conversion optimization recommendations. Built with Next.js 15 and powered by OpenAI, it generates comprehensive reports that users can access from their personal dashboard.

🌐 Available at: pagesense.co

✨ Features

  • AI-Powered Analysis - Uses OpenAI's GPT-4o to identify conversion blockers and optimization opportunities
  • User Dashboard - Personal dashboard to view, manage and track all your website audits
  • User Authentication - Secure authentication system using Firebase Authentication
  • Audit History - View and revisit past audits with detailed reports
  • Optional Downloads - Download your audit reports as PDFs or access them via email
  • Rate Limiting - Firebase-powered rate limiting to prevent abuse
  • Real-time Processing - Serverless functions for fast, scalable auditing
  • Modern UI - Beautiful interface built with Tailwind CSS, shadcn/ui, and motion primitives
  • Responsive Design - Works seamlessly across all devices with mobile-optimized dashboard

πŸš€ Tech Stack

  • Frontend: Next.js 15 (App Router), React 19, TypeScript
  • Styling: Tailwind CSS, shadcn/ui components, Framer Motion
  • Backend: Next.js API Routes (Serverless Functions)
  • Authentication: Firebase Authentication
  • Database: Firebase Firestore for user data and audit storage
  • AI: OpenAI GPT-4o API integration
  • UI Components: Custom MagicUI and motion primitives for enhanced visual effects
  • Deployment: Vercel-ready with automatic serverless function deployment

πŸ“ Project Structure

pagesense/
β”œβ”€β”€ app/
β”‚   β”œβ”€β”€ api/
β”‚   β”‚   β”œβ”€β”€ audit/
β”‚   β”‚   β”‚   └── route.ts          # Main audit API endpoint
β”‚   β”‚   └── hello/
β”‚   β”‚       └── route.ts
β”‚   β”œβ”€β”€ about/
β”‚   β”œβ”€β”€ auth/                     # Authentication pages
β”‚   β”‚   β”œβ”€β”€ login/
β”‚   β”‚   β”œβ”€β”€ signup/
β”‚   β”‚   └── reset-password/
β”‚   β”œβ”€β”€ dashboard/                # User dashboard
β”‚   β”‚   β”œβ”€β”€ ClientWrapper.tsx
β”‚   β”‚   β”œβ”€β”€ DashboardClient.tsx
β”‚   β”‚   └── page.tsx
β”‚   β”œβ”€β”€ templates/
β”‚   β”œβ”€β”€ tool/                     # Audit tool page
β”‚   β”œβ”€β”€ privacy/
β”‚   β”œβ”€β”€ terms/
β”‚   β”œβ”€β”€ globals.css
β”‚   β”œβ”€β”€ layout.tsx
β”‚   └── page.tsx
β”œβ”€β”€ components/
β”‚   β”œβ”€β”€ audit-form/
β”‚   β”‚   β”œβ”€β”€ AuditForm.tsx         # Main audit form component
β”‚   β”‚   └── AuditTitle.tsx
β”‚   β”œβ”€β”€ ui/                       # shadcn/ui components
β”‚   β”œβ”€β”€ magicui/                  # Enhanced UI components with animations
β”‚   └── motion-primitives/        # Animation primitives
β”œβ”€β”€ contexts/
β”‚   └── AuthContext.tsx           # Authentication context provider
β”œβ”€β”€ lib/
β”‚   β”œβ”€β”€ Firebase/
β”‚   β”‚   └── firebaseInit.ts       # Firebase configuration
β”‚   β”œβ”€β”€ formatHTML.ts             # HTML formatter for dashboard display
β”‚   β”œβ”€β”€ utils.ts
β”‚   └── seo.ts
└── public/
    └── [assets]

πŸ”§ API Endpoints

POST /api/audit

Main audit endpoint that processes website analysis requests.

Request Body:

{
  "url": "https://example.com",
  "email": "[email protected]"
}

Response:

  • Analyzes the website using OpenAI
  • Stores the audit result in the user's Firebase collection
  • Sends the audit report via email to the user
  • Provides PDF report for optional download
  • Implements rate limiting for free users

GET /api/hello

Test endpoint for health checks.

🎯 How It Works

  1. User Authentication - Users sign up or log in to access the platform
  2. URL Submission - User enters a website URL to audit from their dashboard
  3. AI Analysis - OpenAI analyzes the landing page for conversion optimization opportunities
  4. Report Generation - The system generates a detailed PDF report
  5. Email & Download Options - Reports are sent via email and available for optional download
  6. Dashboard Access - Users can view all their audits in their personal dashboard
  7. Historical Data - Previous audits are stored and can be accessed at any time

πŸ” Key Features

User Authentication System

  • Firebase Authentication for secure user accounts
  • Email/password and Google sign-in options
  • Password reset functionality
  • Protected routes for authenticated users only

Interactive Dashboard

  • Mobile-optimized with dock-style navigation on small screens
  • Overview of account information and recent activity
  • Access to all previous website audits
  • Quick view of audit scores and details

Responsive Design

  • Mobile-first approach with adaptive layouts
  • Custom components from shadcn/ui
  • Enhanced UI elements with Framer Motion animations
  • Optimized for all screen sizes and devices

Firebase Integration

  • Firestore database for user data storage
  • Real-time data updates
  • Secure data access with authentication rules
  • Efficient document structure for performance

Modern UI Components

  • Custom MagicUI components for enhanced visual effects
  • Motion primitives for smooth animations
  • Dock navigation for mobile interfaces
  • Interactive dialogs for viewing audit reports

❓ Q&A

How does Pagesense work?

Pagesense uses advanced AI to analyze websites and identify conversion optimization opportunities. Users can run audits on any website and receive detailed reports. The AI examines factors like user experience, layout, content clarity, and call-to-action effectiveness to provide actionable recommendations.

Do I need to create an account to use Pagesense?

No, you don't need an account to use our basic audit features. Anyone can analyze a website without signing up. However, creating a free account gives you access to our dashboard where you can save and track your audit history over time.

How many audits can I run?

All users, both with and without accounts, can run up to 3 audits per 24 hours. This helps us maintain service quality while covering our API costs. Premium plans with higher limits may be available in the future.

How can I access my audit results?

For guest users, audit results are displayed immediately after completion and can be optionally downloaded as a PDF. The audit is also sent to your email. If you have an account, all your audit results are saved in your personal dashboard. Simply log in to your account and navigate to the 'Saved Audits' tab to view your previous audits in detail.

How is PageSense different from other SEO tools?

PageSense focuses specifically on conversion optimization rather than just technical SEO. We identify actual conversion blockers that prevent sales and leads, and provide specific recommendations to improve your website's effectiveness at converting visitors.

Is my data secure?

Absolutely. For registered users, we use Firebase Authentication and secure database practices to ensure your account information and audit data remain private. We only store the information necessary to provide our service. For guest users, we don't store any personal information beyond what's needed for rate limiting.

Can I audit any website?

Yes, you can audit any publicly accessible website, including competitor sites. This is perfect for competitive analysis and benchmarking your performance against industry leaders.

How accurate are the AI recommendations?

Our AI recommendations are based on current web standards, conversion rate optimization best practices, and proven techniques used by high-converting websites. Each suggestion includes specific implementation guidance.

πŸ“ License

This project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

See the LICENSE file for full details.

πŸ™‹β€β™‚οΈ Support

For support, email [email protected] or create an issue in this repository.


Built with ❀️ by Jorstors