SerpMorph

Turn Google Search Console data into clear SEO actions.

SerpMorph is a modern SEO analytics app that combines Google Search Console insights with on-page SEO checks in one focused dashboard.

Why SerpMorph

Search Console gives great data, but it can be hard to translate into action quickly. SerpMorph helps by bringing performance metrics and technical checks together so teams can spot issues, prioritize fixes, and track progress in one place.

What It Does

• Secure sign in with Google
• Connect and sync Search Console properties
• Select a domain and explore performance data
• Analyze URLs for on-page and technical SEO factors

Metrics You Can Track

• URLs
• Clicks
• Impressions
• Average ranking position

SEO Checks Included

• Title tag
• Meta description
• Headings structure
• Sitemap availability
• Robots.txt availability

Product Flow

1. Sign in with Google
2. Connect Search Console
3. Choose a domain/property
4. Review performance metrics
5. Run SEO analysis on any URL

Tech Stack

Layer	Tools
Frontend	Next.js 16, React 19, TypeScript
UI	Tailwind CSS, Shadcn UI
Data Fetching	TanStack Query
Backend/Data	Prisma ORM, PostgreSQL (Neon)

Quick Start

1) Install dependencies

npm install

2) Configure environment

Update .env:

DATABASE_URL="your_postgresql_connection_string"

Add Google OAuth and Search Console credentials when authentication and API integration are enabled.

3) Initialize Prisma

npx prisma generate

After defining schema models:

npx prisma migrate dev

4) Start development server

npm run dev

Open http://localhost:3000

Automated Versioning

SerpMorph now uses commit-based automated versioning on merge/push to main.

• GitHub Action: .github/workflows/release.yml
• Release config: .releaserc.json
• Output: version tag, updated package version, CHANGELOG.md, GitHub release

Version bump rules follow Conventional Commits:

• feat: -> minor version bump
• fix: -> patch version bump
• feat!: or BREAKING CHANGE: -> major version bump
• docs: -> patch version bump

No release is generated for:

• chore:
• style:
• test:

Commit Examples

feat(auth): add google oauth callback handling
fix(dashboard): handle empty search console response
feat(api)!: change domain metrics response format

Local Dry Run

You can preview the next version without publishing:

npm run release:dry

Detailed reference:

• Release and Versioning Guide

Roadmap

• Define production-ready Prisma schema
• Implement Google OAuth and secure session handling
• Integrate Search Console API sync
• Build analytics dashboard views
• Implement URL SEO analyzer engine
• Add background sync jobs and alerts

Current Status

Project foundation is set up and ready for feature implementation:

• Core dependencies installed
• Prisma initialized
• Database connection configured
• Skills and tooling added for rapid development