AgentToolHub
Skill

workflow-management

workflow-management — a Claude Code skill from sgcarstrends/sgcarstrends

Features

  • ✓Next.js 16 web app with Cache Components
  • ✓Vercel WDK for data fetching and processing
  • ✓AI-generated blog content with Vercel AI SDK
  • ✓Social media integration across Discord, LinkedIn, etc.
  • ✓MCP server for blog post CRUD operations
  • ✓Fumadocs-powered documentation
  • ✓Vercel deployment with CI/CD

Installation Guide

Prerequisites

  • Node.js >= 22

  • pnpm v10.22.0

    • Installation

    bash
    # Clone the repository
git clone https://github.com/sgcarstrends/sgcarstrends.git
cd sgcarstrends

# Install dependencies
pnpm install

    #### Dependency Management

    This project uses pnpm catalog for centralised dependency version management. Shared dependencies (React, Next.js, TypeScript, testing tools, etc.) are defined in pnpm-workspace.yaml and referenced by workspace packages using the catalog: protocol.

    Key catalog packages:

  • React ecosystem: react (^19.2.3), react-dom (^19.2.3), next (^16.1.0)

  • TypeScript & types: typescript (^5.8.3), @types/node (^22.16.4), @types/react (^19.2.0), @types/react-dom (^19.2.0)

  • Testing tools: vitest (^4.0.15), @vitest/coverage-v8 (^4.0.15)

  • AI & LLM: ai (^6.0.1), @ai-sdk/google (^3.0.6), @langfuse/otel (^4.4.2)

  • Utilities: date-fns (^3.6.0), zod (^4.1.13), sonner (2.0.7)

    • Root-level dependencies (not in catalog):

  • Build tools: turbo (^2.6.3)

  • Code quality: @biomejs/biome (2.3.0), husky (^9.1.7), lint-staged (^16.1.5)

  • Release management: semantic-release (^24.0.0)

    • This ensures version consistency across all workspace packages and simplifies dependency upgrades.

    Development

    bash
    # Development
pnpm dev                    # Run all development servers
pnpm dev:web               # Web application only
cd apps/web && pnpm dev    # Web application development

# Build
pnpm build                 # Build all applications
pnpm build:web             # Build web application only

# Testing
pnpm test                  # Run all unit tests
pnpm test:watch            # Run tests in watch mode
pnpm test:coverage         # Run tests with coverage
pnpm test:web              # Run web tests only
cd apps/web && pnpm test   # Web tests only

# E2E Testing (Web App)
pnpm -F @sgcarstrends/web test:e2e       # Run Playwright E2E tests
pnpm -F @sgcarstrends/web test:e2e:ui    # Run E2E tests with Playwright UI

# Code Quality
pnpm lint                  # Run Biome linting on all packages
pnpm format                # Run Biome formatting on all packages
pnpm lint:web              # Lint web application only
cd apps/web && pnpm lint   # Lint web application only

# Database
pnpm db:migrate            # Run database migrations
pnpm db:migrate:check      # Check migration status
pnpm db:generate           # Generate new migrations
pnpm db:push               # Push schema changes
pnpm db:drop               # Drop database

    Deployment

    Deployment is handled automatically by Vercel:

  • Production: Push to main branch triggers automatic deployment

  • Preview: Pull requests get automatic preview deployments

    • Reviews