Skip to main content

Introducing the Legal Eagle public documentation site

· 3 min read
Ahsan Mahmood
Full-stack engineer (React, Capacitor, Firebase)

The application source code for legaleaglelaws.com is in a private repository — and is going to stay there. The platform handles confidential client matters and publishing the source would be both an indirect security risk and a distraction from the work.

But documentation is different.

Documentation is the part of a product where transparency makes the product more trustworthy, not less. A user who reads how a feature works, what it does not do, and where its limits are is a user who can use it well. Hidden documentation tends to be less rigorous — there's nobody outside the team checking it — and it tends to atrophy because nobody outside the team can correct it.

So as of today, the Legal Eagle Law Firm public documentation lives at legaleaglelaws-docs.aoneahsan.com — an openly licensed (CC BY 4.0), separately hosted Docusaurus site. The repository is public on GitHub at aoneahsan/legaleaglelawfirm-docs; spotting an inaccuracy or want to suggest a clearer way to phrase something, open a pull request.

What's covered​

Three audiences:

  • Visitors and firm clients — how to find a lawyer, book a free consultation, use the AI legal assistant, navigate the firm-client dashboard.
  • Firm staff (admin) — the admin panel, content workflows, plan management. (Pages incrementally being released.)
  • Technically curious readers — a high-level architecture overview, public-safe. No secrets, no internal endpoints. Just the orientation a developer or a journalist needs to evaluate the platform's posture.

How the site is built​

Docusaurus 3.10 on Node 20, TypeScript, MDX. Mermaid for diagrams, @docusaurus/faster (Rspack) for build performance, @docusaurus/plugin-ideal-image for responsive images. Theme is hand-built around the firm's navy-and-gold brand with full dark-mode parity.

The site ships to three deploy targets in parallel:

TargetURLPurpose
Firebase Hosting (firm domain)legaleaglelaws-docs.aoneahsan.comBrand-aligned home
Firebase Hosting (developer domain)legaleaglelaws-docs.aoneahsan.comSame site, second custom domain
GitHub Pagesaoneahsan.github.io/legaleaglelawfirm-docsIndependent search visibility on github.io

Triple deployment is deliberate: GitHub Pages on github.io carries strong domain authority for new technical content, while the brand domains carry the on-brand reading experience.

SEO + AEO posture​

The site follows a strict per-page-uniqueness floor — every documentation page is at least 1 000 words of unique content with a definition-first intro, structured FAQ, explicit limitations, and a last-updated date. AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, Applebot, CCBot) are explicitly allow-listed in robots.txt. A root llms.txt (per llmstxt.org) gives AI agents a curated map. Per-page JSON-LD covers WebSite, Organization, BreadcrumbList, Article, and FAQPage where applicable.

Honest framing is a hard rule. Every page documents what the feature does not do as clearly as what it does. Browser-only privacy claims match reality. No fabricated statistics — anything cited is named and linked.

Author​

I'm Ahsan Mahmood — full-stack engineer specialising in React, Capacitor, and Firebase. I built and maintain the Legal Eagle platform, the SaaS workspace, and this documentation site. The legal practice itself belongs to Advocate Maaz Ahmed Warriach and operates from Office No. 3, 2nd Floor, Kareem Chamber 2, Mozang, Lahore.

If you're hiring, want to chat about a similar project, or like the work and want to support continued maintenance: