Skip to content
View Alabsgold's full-sized avatar
😃
Available
😃
Available

Block or report Alabsgold

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Content in all repositories owned by your account will be closed.
Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
alabsgold/README.md

ALABSGOLD — Boutique Web Engineering & Digital Infrastructure Studio

TypeScript React Vite Tailwind CSS Framer Motion License: MIT

"We engineer digital infrastructure for businesses whose next customer is on another continent, doesn't know them yet, and is deciding—in the first 30 seconds on the site—whether to trust them with money."


🏛️ About ALABSGOLD

Headquartered in Lagos, Nigeria (WAT / GMT+1) and operating globally, ALABSGOLD is an engineering studio founded by Alabi Emmanuel (Alabsgold). The studio designs, fortifies, and ships production-grade web platforms, custom quotation systems, AI retrieval engines, and high-concurrency backends for exporters, luxury real estate operators, and diaspora businesses.

The Problem We Solve: The Structural Credibility Gap

African businesses serving foreign buyers face a structural credibility gap that has nothing to do with product quality. A premium cashew or ginger exporter with international phytosanitary certificates can lose a six-figure contract because of a sluggish page-builder site, broken quotation flows, or an unbranded email address.

ALABSGOLD closes this gap with high-performance engineering: verified compliance showcases, instant page responsiveness, transparent milestone pricing, and hand-rolled Studio backoffices.


⚡ Core Architectural Invariants

  • Zero Page-Builders or Disposable Templates: No WordPress, Elementor, or bloated CMS plugins. Every platform is hand-crafted in type-safe React, Next.js, and Python.
  • Performance as a Conversion Metric: Optimized for sub-second mobile rendering across international latency profiles.
  • Uncompromising Ownership: Clients receive 100% intellectual property ownership, clear documentation, and private Git repository transfer upon milestone completion.
  • Security from First Commit: Webhook HMAC authentication, rate limiting, and parameter validation guards built into the core architecture.
  • Lean, Self-Managed VPS Hosting: Configured on Ubuntu VPS with Nginx reverse proxying, systemd/PM2 process supervision, and automated backup routines—eliminating recurring third-party platform fees.

🗺️ Multi-Page Application Architecture

Route Page Description
/ Home Comprehensive studio overview, interactive Architecture Simulator, featured case studies (Kadie Fresh, NIRA-XT Guardian 2, Atlassian Forge Apps), process overview, and client testimonials.
/services Services & Pricing Three core engineering pillars, authentic milestone pricing tiers with an interactive NGN / International currency toggle, niche industry solution bands, and "What We Don't Do" rules.
/products Products & Labs Categorized portfolio featuring live production platforms, brand identity systems, and R&D lab experiments (PrepAI, PrepCBT, EX-DIGITAL, Project Aegis).
/founder Founder Profile Profile of Founder & Lead Systems Engineer Alabi Emmanuel, 1st place NiRA-XT Hackathon award, Alluvium enterprise SIWES experience, and verified certifications.
/about About Studio Mission statement, the structural credibility gap analysis, 4 studio quality pillars, global operating corridors, and regulatory compliance standards.
/contact Contact & Intake Authentic project intake scoping form, guaranteed 24-hour response SLA (Mon–Sat), direct WhatsApp link (+234 703 996 0964), and Radix UI Accordion FAQs.

🔍 SEO & Social Sharing Engine (useSEO Hook)

The application features a custom React hook (src/hooks/useSEO.ts) that dynamically configures search engine metadata, Open Graph cards, Twitter cards, canonical tags, and Schema.org JSON-LD on every page transition:

  • Dynamic Titles & Descriptions: Tailored per-route for high search click-through rates.
  • Rich Social Cards: Open Graph (og:title, og:description, og:url, og:site_name) and Twitter Card (summary_large_image) tags for Slack, Discord, LinkedIn, X, and WhatsApp link previews.
  • Canonical URL Resolution: Automatically keeps canonical links in sync with client-side history navigation.
  • Schema.org Structured Data: Dynamic JSON-LD schema injection supporting ProfessionalService, Service, CollectionPage, Person, AboutPage, and ContactPage schemas.

🛠️ Technology Stack


🚀 Getting Started

Prerequisites

  • Node.js 18.x or higher
  • npm 9.x or higher

1. Clone the Repository

git clone https://github.com/alabsgold/alabsgold-studio.git
cd alabsgold-studio

2. Install Dependencies

npm install

3. Start Development Server

npm run dev

The application will launch at http://localhost:3000.

4. Code Quality & Linting

npm run lint

5. Production Build

npm run build

Generates optimized, treeshaken static assets in the dist/ directory.


📁 Directory Structure

├── index.html                  # HTML entry point with baseline meta & font definitions
├── metadata.json               # Platform configuration and permissions
├── package.json                # Project dependencies and script runner
├── README.md                   # Project documentation
├── src/
│   ├── App.tsx                 # Main application shell, routing configuration, layout
│   ├── main.tsx                # React DOM root mounting
│   ├── index.css               # Global Tailwind CSS import
│   ├── types.ts                # Centralized TypeScript models and domain interfaces
│   ├── components/             # Reusable UI modules
│   │   ├── AlabsgoldLogo.tsx          # Custom architectural 'A' monogram & studio wordmark
│   │   ├── ArchitectureSimulator.tsx  # Interactive visual dataflow simulator
│   │   ├── CaseStudiesSection.tsx     # Deep-dive engineering breakdowns
│   │   ├── FaqSection.tsx             # Collapsible FAQ accordion with category filter
│   │   ├── Footer.tsx                 # Studio navigation, presence hub, direct desks
│   │   ├── Hero.tsx                   # Studio headline, verified metrics, proof badges
│   │   ├── IntakeModal.tsx            # Floating modal for fast project intake scoping
│   │   ├── InteractiveProjectTimeline.tsx # Framer Motion interactive development stages timeline
│   │   ├── Navbar.tsx                 # Responsive header with route links and CTA
│   │   ├── ProcessSection.tsx         # 5-phase delivery breakdown & boundary rules
│   │   ├── ScrollProgressBar.tsx      # Fixed 2px gold scroll progress indicator
│   │   ├── ServicesSection.tsx        # 3 service pillars overview
│   │   └── TechStackSection.tsx       # Filterable battle-tested primitives
│   ├── data/
│   │   ├── content.ts          # Authentic single-source-of-truth content and records
│   │   └── timelineData.ts     # Stages, tiers, deliverables & code artifacts for timeline
│   ├── hooks/
│   │   └── useSEO.ts           # Dynamic SEO, Open Graph & JSON-LD hook
│   └── pages/                  # Route-level page components
│       ├── AboutPage.tsx       # Studio mission, philosophy & invariants
│       ├── ContactPage.tsx     # Scoping intake form, WhatsApp link & FAQs
│       ├── FounderPage.tsx     # Alabi Emmanuel profile, experience & credentials
│       ├── HomePage.tsx        # Core landing overview
│       ├── ProductsPage.tsx    # Selected works, platforms, and R&D labs
│       └── ServicesPage.tsx    # Detailed service pillars & dual-currency pricing

📬 Contact & Studio Desks


⚖️ License

Distributed under the MIT License. See LICENSE for more information.

Popular repositories Loading

  1. ex_digital_2 ex_digital_2 Public

    Team EX-Coders solution NACOS 2025/2026 Hackathon

    TypeScript 3

  2. Confluence-Knowledge-Freshness-Agent Confluence-Knowledge-Freshness-Agent Public

    A simple repository to get inclined with forge

    JavaScript 2

  3. church-app church-app Public

    JavaScript 1

  4. dns_test dns_test Public

    Python 1 1

  5. Crypto-Mastery-Hub-1.0 Crypto-Mastery-Hub-1.0 Public

    HTML 1

  6. Portfolio Portfolio Public

    JavaScript 1