diff --git a/.agents/product-marketing-context.md b/.agents/product-marketing-context.md new file mode 100644 index 0000000..c933921 --- /dev/null +++ b/.agents/product-marketing-context.md @@ -0,0 +1,166 @@ +# Product Marketing Context + +*Last updated: 2026-03-25* + +## Product Overview +**One-liner:** Bay Area IT is a local managed IT and business technology partner for small and mid-sized businesses in Corpus Christi and the Coastal Bend. + +**What it does:** The company provides ongoing IT support, help desk, network infrastructure, business email, device support, security basics, backups, and related technology services for local businesses. It also offers adjacent services such as web design, shared drive setup, printer/scanner installation, and hardware procurement. The positioning throughout the site emphasizes reliable day-to-day operations, fast support, and a local partner that can help remotely or on-site. + +**Product category:** Managed IT services, IT support, outsourced IT support, IT help desk, business technology services for SMBs. + +**Product type:** Local B2B service business. + +**Business model:** Service-led business with monthly recurring support plans plus project-based services. Pricing signals on the site suggest transparent monthly pricing for support and per-unit pricing for some offers (example: business email at `$5` per inbox). Primary conversion is a free 20-minute assessment / consultation. + +## Target Audience +**Target companies:** Small and mid-sized businesses in Corpus Christi and the broader Coastal Bend, including Portland, Rockport, Aransas Pass, Kingsville, and Port Aransas. Strong fit for offices, service businesses, healthcare-related practices, growing teams, and companies without a full in-house IT department. + +**Decision-makers:** Business owners, office managers, operations leaders, and IT-responsible managers at SMBs. Secondary audiences likely include executive assistants, practice managers, and internal technical contacts who influence vendor selection. + +**Primary use case:** Outsource day-to-day IT management so the business can reduce downtime, improve security, and keep employees productive without building a full internal IT team. + +**Jobs to be done:** +- Keep our systems, email, devices, Wi-Fi, and users working reliably every day. +- Give employees a clear support channel so small issues stop turning into business delays. +- Put practical security, backup, and monitoring in place without overcomplicating the environment. + +**Use cases:** +- Ongoing managed IT support for SMBs without in-house IT +- Remote-first help desk with on-site escalation when needed +- Business email setup, migration, and support +- Network cleanup, Wi-Fi improvement, firewall/router/switch management +- New user onboarding, device setup, and account/access support +- Web design and domain/DNS support for small local businesses + +## Personas +| Persona | Cares about | Challenge | Value we promise | +|---------|-------------|-----------|------------------| +| Business owner / President | Predictable costs, fewer disruptions, trust in provider, fast escalation | They are tired of acting as part-time IT and losing time to avoidable issues | We take IT ownership off their plate with clear communication, local accountability, and practical support | +| Office manager / Operations lead | Employee productivity, quick fixes, simple process, dependable vendor | Staff lose time to recurring tickets, login issues, printer/email/network friction | We give your team a responsive help desk and structured support workflow that keeps work moving | +| Practice manager / Admin lead | Reliability, compliance-adjacent security basics, smooth communication systems | Email, devices, and access issues disrupt client or patient-facing work | We stabilize the environment and implement simple security and backup foundations | +| Internal technical contact | Competence, clean implementation, sane network/security setup | They need outside help without inheriting chaos or vague recommendations | We provide hands-on implementation, monitoring, and support without unnecessary complexity | +| Financial buyer | Cost control, ROI, avoiding headcount, lower risk | Hiring full-time IT is expensive and overkill for many SMBs | Outsourced IT gives predictable monthly pricing and broader coverage than a single in-house hire | + +## Problems & Pain Points +**Core problem:** Business technology has become unpredictable, reactive, and distracting. Employees hit avoidable issues, support requests pile up, and owners or managers end up spending time managing IT instead of running the business. + +**Why alternatives fall short:** +- Break-fix support is reactive and does not create ongoing stability +- Remote-only national providers can feel slow, generic, and disconnected from local urgency +- A single in-house generalist is expensive and may not cover the full range of needs +- DIY setups for email, networking, security, and backups create hidden fragility + +**What it costs them:** Lost productivity, downtime, delayed customer response, missed emails, security exposure, recurring employee frustration, and management time pulled away from growth. + +**Emotional tension:** Frustration, lack of confidence in systems, fear of outages or security incidents, and fatigue from being forced to “figure IT out” internally. + +## Competitive Landscape +**Direct:** Local MSPs and IT support providers in Corpus Christi / Coastal Bend — often positioned similarly on help desk, managed IT, and outsourced support; likely to fall short on responsiveness, communication clarity, or service breadth if they are inconsistent. + +**Secondary:** Freelance IT technicians, break-fix computer repair shops, and one-person outsourced support providers — cheaper upfront but often reactive, less structured, and weaker on ongoing monitoring, security baselines, and business process support. + +**Indirect:** Hiring an internal IT employee, relying on a tech-savvy office employee, or using vendor support from Microsoft/Google/ISP/hardware providers — these options are fragmented, slower for cross-system problems, and usually do not provide clear ownership of the full environment. + +## Differentiation +**Key differentiators:** +- Local provider based in Corpus Christi with regional service coverage +- Remote-first support with on-site availability when needed +- Broad business technology scope: help desk, email, networking, devices, security basics, backups, web, DNS/domain support +- Clear, practical positioning instead of overly technical jargon +- Free 20-minute assessment as a low-friction first step + +**How we do it differently:** We position the company as a local IT partner that combines fast support, hands-on implementation, and practical business judgment. The site consistently emphasizes reliable operations, simple explanations, and support that fits SMB reality rather than enterprise complexity. + +**Why that's better:** SMB buyers get one accountable partner, faster issue resolution, lower management overhead, and support that balances remote speed with local presence. + +**Why customers choose us:** They want predictable help, local accountability, straightforward communication, and a provider who can support everyday business operations instead of only isolated technical tasks. + +## Objections +| Objection | Response | +|-----------|----------| +| “We’re too small to need managed IT.” | Small businesses are often the most disrupted by recurring tech issues because they have less internal coverage. Outsourced support gives you structure and expertise without hiring a full-time team. | +| “We already have someone who helps with IT.” | That can work until issues span email, networking, security, users, and vendors at the same time. We provide broader coverage, clearer ownership, and ongoing support instead of ad hoc fixes. | +| “A remote provider or break-fix shop is cheaper.” | Lower upfront cost usually means slower response, less accountability, and more recurring issues. The site’s positioning is around reducing downtime and management distraction, not just closing tickets cheaply. | + +**Anti-persona:** Large enterprises with internal IT departments and complex procurement, buyers shopping only on the lowest hourly rate, and organizations that want purely transactional break-fix work with no ongoing relationship. + +## Switching Dynamics +**Push:** Recurring downtime, slow systems, unresolved support tickets, weak Wi-Fi, email problems, unclear ownership, and security/backups that feel too risky to ignore. + +**Pull:** Local support, fast response, clear communication, monthly support options, practical security baseline, and an easy first step via a free assessment. + +**Habit:** Existing vendor relationships, internal workarounds, “good enough” support, reluctance to document the current environment, and the inertia of staying reactive. + +**Anxiety:** Fear of disruption during migration, concern about cost, worry that the new provider will overcomplicate things, and uncertainty about whether a local MSP will actually be more responsive. + +## Customer Language +**How they describe the problem:** +- “The internet is slow.” +- “The system is glitchy.” +- “Our email stopped working.” +- “Support requests never end.” +- “I’m tired of playing part-time IT.” +- “We need reliable IT without hiring in-house staff.” + +**How they describe us:** +- “Local IT support” +- “Outsourced IT support” +- “Fast remote assistance with on-site support when needed” +- “Reliable IT partner” +- “Help desk for employees” + +**Words to use:** reliable, local, fast response, outsourced IT support, help desk, remote support, on-site when needed, security baseline, backup monitoring, predictable monthly pricing, practical, clear, business-focused. + +**Words to avoid:** revolutionary, cutting-edge for its own sake, AI-first, disruption, synergy, enterprise transformation, generic “digital innovation” language. + +**Glossary:** +| Term | Meaning | +|------|---------| +| Managed IT / ongoing IT support | Recurring support relationship covering maintenance, issue resolution, and operational stability | +| Help desk | Day-to-day employee support for access, software, device, and common IT issues | +| Security baseline | Practical protection measures like MFA, patching, endpoint protection, and backup basics | +| Remote-first support | Resolving most issues quickly without waiting for an on-site visit | +| On-site support | Physical support for hardware, installations, and network troubleshooting when required | + +## Brand Voice +**Tone:** Professional, direct, practical, reassuring. + +**Style:** Conversational but credible. Explains technical work in business terms. Avoids jargon-heavy positioning and stays grounded in outcomes like uptime, productivity, and reliability. + +**Personality:** Local, dependable, clear, experienced, no-nonsense. + +## Proof Points +**Metrics:** +- 25+ years serving the region appears repeatedly across location/service pages +- 30+ local businesses supported appears across multiple pages +- 99.9% uptime and `<2 min` response time appear on the About page +- Assessments can begin within 48 hours +- 24/7 emergency support / monitoring is referenced in contact and CTA copy + +**Customers:** No named logos surfaced in the repo copy reviewed. The site references local businesses across the Coastal Bend rather than public logos. + +**Testimonials:** +> No direct testimonial quotes were found in the repo sections reviewed. Add real customer quotes here when available. + +**Value themes:** +| Theme | Proof | +|-------|-------| +| Local trust | Corpus Christi address, repeated local positioning, service-area pages for Coastal Bend cities | +| Reliability | 99.9% uptime claim, remote-first help desk, proactive maintenance and monitoring language | +| Experience | 25+ years claim across pages; long-standing regional presence | +| Business fit | Positioning for small and mid-sized businesses without in-house IT | +| Speed | Fast response, emergency support, assessments within 48 hours | + +## Goals +**Business goal:** Generate qualified local SMB leads for managed IT, help desk, business email, networking, and related technology services. + +**Conversion action:** Book a free 20-minute assessment / consultation or submit a contact inquiry / call the office. + +**Current metrics:** Not fully established from the repo alone. Repo signals include claims around 30+ businesses supported, 99.9% uptime, fast response, and 48-hour assessment turnaround. Customer-count references conflict in the codebase and should be normalized before using in external collateral. + +## Open Questions / Conflicts To Resolve +- Brand name is inconsistent: `Bay Area Affiliates`, `Bay Area IT`, and `Bay Area IT Services` all appear in the repo. +- Customer count is inconsistent: some pages say `30+ local businesses`, while `AboutPage` also says `over 150 businesses`. +- Founding timeline is inconsistent: timeline starts in `2000`, but hero/about copy also says `Since 2010`. +- Pricing clarity is partial: one service has explicit `$5 per inbox` pricing, while broader managed IT pricing is only described as transparent monthly pricing. diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..20c690b --- /dev/null +++ b/.dockerignore @@ -0,0 +1,15 @@ +.git +.gitignore +.agents +node_modules +dist +*.log +Dockerfile +docker-compose.yml +README.md +*.md +bullet +ellipsis +em +left +right diff --git a/.gitignore b/.gitignore index a547bf3..4108b33 100644 --- a/.gitignore +++ b/.gitignore @@ -1,24 +1,24 @@ -# Logs -logs -*.log -npm-debug.log* -yarn-debug.log* -yarn-error.log* -pnpm-debug.log* -lerna-debug.log* - -node_modules -dist -dist-ssr -*.local - -# Editor directories and files -.vscode/* -!.vscode/extensions.json -.idea -.DS_Store -*.suo -*.ntvs* -*.njsproj -*.sln -*.sw? +# Logs +logs +*.log +npm-debug.log* +yarn-debug.log* +yarn-error.log* +pnpm-debug.log* +lerna-debug.log* + +node_modules +dist +dist-ssr +*.local + +# Editor directories and files +.vscode/* +!.vscode/extensions.json +.idea +.DS_Store +*.suo +*.ntvs* +*.njsproj +*.sln +*.sw? diff --git a/App.tsx b/App.tsx index dff70be..93d049c 100644 --- a/App.tsx +++ b/App.tsx @@ -1,65 +1,93 @@ -import React, { useEffect } from 'react'; -import { BrowserRouter as Router, Routes, Route, useLocation } from 'react-router-dom'; -import Lenis from '@studio-freight/lenis'; +import React, { Suspense, useEffect, useRef } from 'react'; +import { BrowserRouter as Router, Routes, Route, Navigate, useLocation } from 'react-router-dom'; import gsap from 'gsap'; import { ScrollTrigger } from 'gsap/ScrollTrigger'; import { ScrollToPlugin } from 'gsap/ScrollToPlugin'; import Navbar from './components/Navbar'; import Footer from './components/Footer'; import BackToTop from './components/BackToTop'; -import HomePage from './src/pages/HomePage'; -import AboutPage from './src/pages/AboutPage'; -import ServicesPage from './src/pages/ServicesPage'; -import BlogPage from './src/pages/BlogPage'; -import ContactPage from './src/pages/ContactPage'; -import LocationPage from './src/pages/LocationPage'; -import ServicePage from './src/pages/ServicePage'; -import BlogPostPage from './src/pages/BlogPostPage'; -import { locationData, serviceData, blogPostData } from './src/data/seoData'; +import { BlogSeoRoute, LocationSeoRoute, ServiceSeoRoute, blogRoutes, locationRoutes, serviceRoutes, legacyRedirects } from './src/routes/seoRoutes'; // Register GSAP plugins globally gsap.registerPlugin(ScrollTrigger, ScrollToPlugin); +import HomePage from './src/pages/HomePage'; +const AboutPage = React.lazy(() => import('./src/pages/AboutPage')); +const ServicesPage = React.lazy(() => import('./src/pages/ServicesPage')); +const BlogPage = React.lazy(() => import('./src/pages/BlogPage')); +const ContactPage = React.lazy(() => import('./src/pages/ContactPage')); +const LocationsPage = React.lazy(() => import('./src/pages/LocationsPage')); +const PrivacyPolicyPage = React.lazy(() => import('./src/pages/PrivacyPolicyPage')); +const TermsOfServicePage = React.lazy(() => import('./src/pages/TermsOfServicePage')); + // Grain Overlay Component const GrainOverlay = () => (
); +const RouteFallback = () => ( +
+ Loading page... +
+); + const AppContent: React.FC = () => { const location = useLocation(); + const lenisRef = useRef(null); useEffect(() => { - // Initialize Lenis for smooth scrolling - const lenis = new Lenis({ - duration: 1.2, - easing: (t) => Math.min(1, 1.001 - Math.pow(2, -10 * t)), - direction: 'vertical', - gestureDirection: 'vertical', - smooth: true, - smoothTouch: false, - touchMultiplier: 2, - } as any); + if (typeof window === 'undefined') { + return; + } - // Synchronize Lenis with GSAP ScrollTrigger - lenis.on('scroll', ScrollTrigger.update); + const prefersReducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)'); + const finePointer = window.matchMedia('(pointer: fine) and (hover: hover)'); - const ticker = (time: number) => { - lenis.raf(time * 1000); - }; + if (prefersReducedMotion.matches || !finePointer.matches) { + return; + } - // Use GSAP ticker for smoother animation loop integration - gsap.ticker.add(ticker); + let active = true; + let ticker: ((time: number) => void) | null = null; - // Disable lag smoothing to prevent jumps - gsap.ticker.lagSmoothing(0); + void import('@studio-freight/lenis').then(({ default: Lenis }) => { + if (!active) { + return; + } - // Reset scroll on route change - lenis.scrollTo(0, { immediate: true }); + const lenis = new Lenis({ + duration: 1.2, + easing: (t) => Math.min(1, 1.001 - Math.pow(2, -10 * t)), + direction: 'vertical', + gestureDirection: 'vertical', + smooth: true, + smoothTouch: false, + touchMultiplier: 2, + } as any); + + lenisRef.current = lenis; + lenis.on('scroll', ScrollTrigger.update); + + ticker = (time: number) => { + lenis.raf(time * 1000); + }; + + gsap.ticker.add(ticker); + gsap.ticker.lagSmoothing(0); + }); return () => { - gsap.ticker.remove(ticker); - lenis.destroy(); + active = false; + if (ticker) { + gsap.ticker.remove(ticker); + } + lenisRef.current?.destroy(); + lenisRef.current = null; }; + }, []); + + useEffect(() => { + lenisRef.current?.scrollTo(0, { immediate: true }); }, [location.pathname]); return ( @@ -67,40 +95,55 @@ const AppContent: React.FC = () => {
- - } /> - } /> - } /> - } /> - } /> + }> + + } /> + } /> + } /> + } /> + } /> + } /> + } /> + } /> - {/* SEO Location Pages */} - {locationData.map((data) => ( - } - /> - ))} + {/* SEO Location Pages */} + {locationRoutes.map((data) => ( + + } + /> + + ))} - {/* SEO Service Pages */} - {serviceData.map((data) => ( - } - /> - ))} + {/* SEO Service Pages */} + {serviceRoutes.map((data) => ( + + } + /> + + ))} - {/* Authority Blog Posts */} - {blogPostData.map((data) => ( - } - /> - ))} - + {/* Authority Blog Posts */} + {blogRoutes.map((data) => ( + + } + /> + + ))} + + {/* Legacy URL redirects — preserve old flat URLs */} + {legacyRedirects.map(({ from, to }) => ( + + } /> + + ))} + +