# AGENTS.md — DevBlock Technologies

## What We Do

DevBlock Technologies is a software development company that builds custom web applications, mobile apps, cloud infrastructure, and AI/ML solutions for businesses. We translate visionary ideas into high-performance software products.

## Tech Stack

- **Frontend:** React, Next.js 16 (App Router), TypeScript, Tailwind CSS, Framer Motion
- **Backend:** Node.js, Python (Flask), MongoDB
- **Infrastructure:** Vercel, Cloudflare, AWS
- **Mobile:** React Native
- **AI/ML:** Python-based inference engines, intelligent chatbots, recommendation systems

## Project Structure

This is a **Next.js 16 static export** site (output: 'export' in next.config.mjs). Key constraints:

- Types are ignored (`ignoreBuildErrors: true`) — focus on runtime correctness
- No server components or dynamic features — everything must work with static export
- Images are unoptimized (`images.unoptimized: true`)
- Package manager: **pnpm**

### Key Directories

```
app/                    # Next.js App Router pages (all static)
  page.tsx              # Home page
  about/                # About page
  services/             # Services page
  work/                 # Portfolio/work page
  projects/[slug]/      # Individual project case studies
  insights/             # Blog listing
  insights/[slug]/      # Individual blog articles
  contact/              # Contact page
  careers/              # Careers page
  terms/                # Terms of service
  privacy/              # Privacy policy
  layout.tsx            # Root layout with metadata, JSON-LD
  sitemap.ts            # Dynamic sitemap generation
  robots.ts             # Robots.txt configuration
constants/
  project.ts            # Project data (hardcoded)
  tech.ts               # Technology icons
components/             # Shared UI components
public/
  docs/manuals/         # PDF documentation
  images/               # Static images
  llms.txt              # LLM-friendly site index
  sitemap.md            # Human-readable sitemap
  AGENTS.md             # This file
```

## Where to Find Documentation

- **PDF Manuals:** `public/docs/manuals/` — contains detailed manuals for DevBlock Console, SDK, Snitch Worker, Ingest Server, and more
- **Blog / Insights:** `app/insights/` — hardcoded mockPosts/mockPostsContent with product stories and technical deep dives
- **Project Case Studies:** `constants/project.ts` — project data including stack, audits, and metrics

## Build & Development

```bash
pnpm install        # Install dependencies
pnpm dev            # Start development server
pnpm build          # Build for production (static export)
pnpm start          # Start production server
```

## Key Conventions

- **Production domain:** devblocktechnologies.com.ng (devblock.tech is an alias)
- **Styling:** Tailwind CSS with dark/light mode support
- **Animations:** Framer Motion with staggered container/item patterns
- **UI Components:** Custom components in `components/ui/` based on shadcn/ui patterns
- **Blog content:** Hardcoded in client components — no CMS integration
- **Project data:** Centralized in `constants/project.ts`

## SEO / Agent Discovery

- `public/llms.txt` — LLM-optimized site index (llmstxt.org spec)
- `public/sitemap.md` — Human-readable sitemap with all pages and descriptions
- JSON-LD structured data on all pages (Organization, WebSite, Blog, Article, SoftwareApplication schemas)
- Breadcrumb JSON-LD on all subpages
- All OpenGraph URLs point to the production domain

## Contact

- **Website:** https://devblocktechnologies.com.ng
- **GitHub:** https://github.com/ojibona1
- **Email:** legal@devblocktechnologies.com.ng