> ## Documentation Index
> Fetch the complete documentation index at: https://site.aspect.build/llms.txt
> Use this file to discover all available pages before exploring further.

# Monorepo — Aspect Build Blog

> 10 Monorepo posts from the Aspect Build engineering blog on Bazel and developer productivity.

export const BlogCard = ({title, description, date, authors, tags, image, href, children}) => {
  const tagList = tags ? tags.split(", ").filter(Boolean) : [];
  const tagSlug = t => t.toLowerCase().replace(/&/g, "").replace(/\+/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
  const formattedDate = date ? new Date(date + "T00:00:00").toLocaleDateString("en-US", {
    year: "numeric",
    month: "short",
    day: "numeric"
  }) : "";
  const resolvedImage = typeof image === "string" && image.trim() === "" ? null : image;
  return <div data-tags={tagList.join(",")} className="blog-card flex flex-col rounded-xl border border-zinc-200 dark:border-zinc-700 bg-white dark:bg-zinc-800 overflow-hidden hover:shadow-lg transition group">
      <a href={href} className="block">
        {resolvedImage ? typeof resolvedImage === "string" ? <img noZoom src={resolvedImage} alt={title} className="w-full" style={{
    height: "180px",
    objectFit: "cover"
  }} /> : <div className="blog-card-image">{resolvedImage}</div> : children ? <div className="blog-card-image">{children}</div> : null}
        <div className="px-5 pt-5">
          <h3 className="text-lg font-semibold text-zinc-900 dark:text-white group-hover:text-blue-600 dark:group-hover:text-blue-400 transition">
            {title}
          </h3>
          {description && <p className="mt-2 text-sm text-zinc-600 dark:text-zinc-400 line-clamp-2">
              {description}
            </p>}
          <div className="flex items-center gap-2 mt-3 text-xs text-zinc-500 dark:text-zinc-400">
            {authors && <span>{authors}</span>}
            {authors && formattedDate && <span>·</span>}
            {formattedDate && <span>{formattedDate}</span>}
          </div>
        </div>
      </a>
      {tagList.length > 0 && <div className="flex flex-wrap gap-1.5 px-5 pb-4 pt-3 mt-auto">
          {tagList.map(tag => <a key={tag} href={"/blog/tags/" + tagSlug(tag)} className="px-2 py-0.5 rounded-full text-xs bg-zinc-100 dark:bg-zinc-800 text-zinc-600 dark:text-zinc-400 hover:bg-blue-100 dark:hover:bg-blue-900/40 hover:text-blue-700 dark:hover:text-blue-300 transition">
              {tag}
            </a>)}
        </div>}
    </div>;
};

export const MarketingPage = () => <div className="marketing-page-marker" style={{
  display: "none"
}} />;

export const Section = ({children, className = "", gray = false, dark = false, id}) => <section id={id} className={`w-full flex justify-center px-4 py-16 md:py-24 ${gray ? "bg-gray-50 dark:bg-zinc-900" : dark ? "bg-zinc-900 dark:bg-zinc-950" : ""} ${className}`}>
    <div className="w-full" style={{
  maxWidth: "1140px"
}}>
      {children}
    </div>
  </section>;

export const Hero = ({title, subtitle, badge, eyebrow, heroImageClassName = "", primaryCta, primaryHref = "#", secondaryCta, secondaryHref = "#", centered = true, children}) => <section className="w-full flex justify-center px-4 pt-16 pb-16 md:pt-24 md:pb-24" style={{
  background: "linear-gradient(180deg, var(--hero-gradient-start, #f8fafc) 0%, var(--hero-gradient-end, #ffffff) 100%)"
}}>
    <div className="w-full" style={{
  maxWidth: "1140px"
}}>
      {centered && !children ? <div className="flex flex-col items-center text-center">
          {badge && <div className="inline-flex items-center gap-2 px-4 py-1.5 rounded-full bg-blue-50 dark:bg-blue-900/30 border border-blue-200 dark:border-blue-700 text-blue-700 dark:text-blue-300 text-sm font-medium mb-6">
              {badge}
            </div>}
          {eyebrow && <div className="text-xs font-semibold tracking-widest uppercase text-blue-600 dark:text-blue-400 mb-4">
              {eyebrow}
            </div>}
          <h1 className="text-4xl md:text-5xl font-semibold text-zinc-900 dark:text-white leading-tight tracking-tight" style={{
  maxWidth: "820px"
}}>
            {String(title).split(/\\n|\n/).map((line, i) => i ? [<br key={i} />, line] : line)}
          </h1>
          {subtitle && <div className="subtitle-gap text-lg md:text-xl text-zinc-500 dark:text-zinc-300 leading-relaxed" style={{
  marginTop: "1rem",
  maxWidth: "600px"
}}>
              {subtitle}
            </div>}
          <div className="flex flex-wrap gap-3 mt-10 justify-center">
            {primaryCta && <a href={primaryHref} className="inline-flex items-center px-6 py-3 rounded-lg bg-blue-600 text-white font-semibold hover:bg-blue-700 transition shadow-sm">
                {primaryCta}
              </a>}
            {secondaryCta && <a href={secondaryHref} className={`inline-flex items-center px-6 py-3 rounded-lg border border-zinc-300 dark:border-zinc-600 text-zinc-700 dark:text-zinc-200 font-semibold hover:bg-zinc-50 dark:hover:bg-zinc-800 transition ${secondaryHref === "/request-demo" ? "demo-gradient-btn" : ""}`}>
                {secondaryCta}
              </a>}
          </div>
        </div> : <div className="flex flex-col md:flex-row items-center gap-10 md:gap-16">
          <div className="flex-1 min-w-0">
            {badge && <div className="inline-flex items-center gap-2 px-4 py-1.5 rounded-full bg-blue-50 dark:bg-blue-900/30 border border-blue-200 dark:border-blue-700 text-blue-700 dark:text-blue-300 text-sm font-medium mb-6">
                {badge}
              </div>}
            {eyebrow && <div className="text-xs font-semibold tracking-widest uppercase text-blue-600 dark:text-blue-400 mb-4">
                {eyebrow}
              </div>}
            <h1 className="text-4xl md:text-5xl font-semibold text-zinc-900 dark:text-white leading-tight tracking-tight">
            {String(title).split(/\\n|\n/).map((line, i) => i ? [<br key={i} />, line] : line)}
          </h1>
            {subtitle && <div className="subtitle-gap text-lg md:text-xl text-zinc-500 dark:text-zinc-300 leading-relaxed" style={{
  marginTop: "1rem"
}}>
                {subtitle}
              </div>}
            <div className="flex flex-wrap gap-3 mt-8">
              {primaryCta && <a href={primaryHref} className="inline-flex items-center px-6 py-3 rounded-lg bg-blue-600 text-white font-semibold hover:bg-blue-700 transition shadow-sm">
                  {primaryCta}
                </a>}
              {secondaryCta && <a href={secondaryHref} className={`inline-flex items-center px-6 py-3 rounded-lg border border-zinc-300 dark:border-zinc-600 text-zinc-700 dark:text-zinc-200 font-semibold hover:bg-zinc-50 dark:hover:bg-zinc-800 transition ${secondaryHref === "/request-demo" ? "demo-gradient-btn" : ""}`}>
                  {secondaryCta}
                </a>}
            </div>
          </div>
          {children && <div className={`flex-1 min-w-0 hero-image ${heroImageClassName}`}>
              {children}
            </div>}
        </div>}
    </div>
  </section>;

<MarketingPage />

<Hero title="Posts tagged Monorepo" subtitle="Engineering writing from the Aspect team on Monorepo." centered={true} />

<Section>
  <div className="mb-8">
    <a href="/blog" className="text-blue-600 dark:text-blue-400 font-semibold hover:underline">← All posts</a>
    <span className="mx-2 text-zinc-400">·</span>
    <a href="/blog/tags" className="text-blue-600 dark:text-blue-400 font-semibold hover:underline">Browse all tags</a>
  </div>

  <div className="marketing-grid-3">
    <BlogCard title="Keeping main green in a monorepo" description="Explore how to prevent red main branches with merge queues, on-call policies, and better CI practices to improve development workflows and team efficiency." date="2024-06-21" authors="Alex Eagle" href="/blog/keeping-main-green" tags="Monorepo, CI/CD">
      <img noZoom src="https://mintcdn.com/aspectbuild/x1L7Iep716jCyJVo/images/blog/hashnode/hn-9071e4d0f6.jpeg?fit=max&auto=format&n=x1L7Iep716jCyJVo&q=85&s=3c35acebf82edbee6421490d4c6bad53" alt="" width="1600" height="1200" data-path="images/blog/hashnode/hn-9071e4d0f6.jpeg" />
    </BlogCard>

    <BlogCard title="CODEOWNERS and Bazel" description="Learn how to manage code ownership in monorepos using CODEOWNERS, OWNERS files, and tools like Bazel for better code review workflows." date="2024-03-20" authors="Alex Eagle" href="/blog/codeowners-and-bazel" tags="Bazel, Monorepo">
      <img noZoom src="https://mintcdn.com/aspectbuild/x1L7Iep716jCyJVo/images/blog/hashnode/hn-a8a7130c32.jpeg?fit=max&auto=format&n=x1L7Iep716jCyJVo&q=85&s=5e7e16dc93d6d0b3c94391d57f8d1981" alt="" width="1509" height="694" data-path="images/blog/hashnode/hn-a8a7130c32.jpeg" />
    </BlogCard>

    <BlogCard title="Preventing production code depending on experiments" description="Learn how to manage experimental code in Bazel monorepos by restricting dependencies and ensuring faster iteration without risking production builds." date="2024-03-15" authors="Alex Eagle" href="/blog/preventing-production-code-depending-on-experiments" tags="Bazel, Monorepo">
      <img noZoom src="https://mintcdn.com/aspectbuild/x1L7Iep716jCyJVo/images/blog/hashnode/hn-128f5e6ec9.jpeg?fit=max&auto=format&n=x1L7Iep716jCyJVo&q=85&s=df982f37e2715325a0cabd8f9f21f73c" alt="" width="1600" height="1065" data-path="images/blog/hashnode/hn-128f5e6ec9.jpeg" />
    </BlogCard>

    <BlogCard title="Easier merges on lockfiles" description="Resolve lockfile merge conflicts automatically with Git's 'ours' merge driver, streamlining your workflow and avoiding manual fixes." date="2024-01-22" authors="Alex Eagle" href="/blog/easier-merges-on-lockfiles" tags="Monorepo, JavaScript, Bazel">
      <img noZoom src="https://mintcdn.com/aspectbuild/x1L7Iep716jCyJVo/images/blog/hashnode/hn-9859a7d82b.jpeg?fit=max&auto=format&n=x1L7Iep716jCyJVo&q=85&s=f17678cae0fa97182f07910fa550feab" alt="" width="1254" height="836" data-path="images/blog/hashnode/hn-9859a7d82b.jpeg" />
    </BlogCard>

    <BlogCard title="Mechanics of moving an other-repo to the monorepo" description="Learn the step-by-step process of merging projects into a Bazel monorepo, preserving git history, and setting up smooth CI/CD workflows." date="2023-05-18" authors="Alex Eagle" href="/blog/otherrepo-to-monorepo" tags="Monorepo, Migration, Bazel">
      <img noZoom src="https://mintcdn.com/aspectbuild/x1L7Iep716jCyJVo/images/blog/stock/containers.jpg?fit=max&auto=format&n=x1L7Iep716jCyJVo&q=85&s=fe4ce250299b50bebca610ca0325eb6c" alt="" width="800" height="533" data-path="images/blog/stock/containers.jpg" />
    </BlogCard>

    <BlogCard title="Versioning releases from a monorepo" description="Guide to versioning releases from a monorepo, exploring trunk-based development and monoversion strategies for streamlined software development." date="2022-11-22" authors="Alex Eagle" href="/blog/versioning-releases-from-a-monorepo" tags="Releases, Monorepo">
      <img noZoom src="https://mintcdn.com/aspectbuild/x1L7Iep716jCyJVo/images/blog/hashnode/hn-86bcd6229d.jpeg?fit=max&auto=format&n=x1L7Iep716jCyJVo&q=85&s=41ba384b4855a6330b054145077962a8" alt="" width="1600" height="1067" data-path="images/blog/hashnode/hn-86bcd6229d.jpeg" />
    </BlogCard>

    <BlogCard title="Moving TypeScript code into a Bazel monorepo" description="Step-by-step guide for migrating TypeScript projects into a Bazel monorepo, ensuring smooth workflow and effective governance." date="2022-09-16" authors="Alex Eagle" href="/blog/moving-typescript-to-bazel-monorepo" tags="TypeScript, Monorepo, Migration, Bazel">
      <img noZoom src="https://mintcdn.com/aspectbuild/x1L7Iep716jCyJVo/images/blog/stock/code-screen.jpg?fit=max&auto=format&n=x1L7Iep716jCyJVo&q=85&s=26d6041369d0365dff1cce13ba0ff704" alt="" width="800" height="534" data-path="images/blog/stock/code-screen.jpg" />
    </BlogCard>

    <BlogCard title="Monorepo Shared Green" description="Learn about the benefits of implementing a \\&#x22;shared green\\&#x22; monobuild model in a monorepo for improved code sharing and consistency" date="2022-08-08" authors="Alex Eagle" href="/blog/monorepo-shared-green" tags="Monorepo, CI/CD">
      <img noZoom src="https://mintcdn.com/aspectbuild/x1L7Iep716jCyJVo/images/blog/hashnode/hn-22114cf9a4.jpeg?fit=max&auto=format&n=x1L7Iep716jCyJVo&q=85&s=d54583a6ac224882752e712c89eedab3" alt="" width="1600" height="1067" data-path="images/blog/hashnode/hn-22114cf9a4.jpeg" />
    </BlogCard>

    <BlogCard title="Documentation in source control" description="Store developer documentation in source control for easy access, versioning, and collaboration, but consider presentation and ease of editing" date="2022-03-10" authors="Alex Eagle" href="/blog/docs-in-vcs" tags="Monorepo, Bazel">
      <img noZoom src="https://mintcdn.com/aspectbuild/x1L7Iep716jCyJVo/images/blog/hashnode/hn-228096110f.jpeg?fit=max&auto=format&n=x1L7Iep716jCyJVo&q=85&s=623798a7a66957cf97663cdef8986949" alt="" width="1600" height="1068" data-path="images/blog/hashnode/hn-228096110f.jpeg" />
    </BlogCard>

    <BlogCard title="CBOI: Continuous Build, Occasional Integration" description="\\&#x22;Continuous Build, Occasional Integration\\&#x22; fails in software development and how to switch to effective Continuous Integration" date="2021-05-10" authors="Alex Eagle" href="/blog/cboi-continuous-build-occasional-integration" tags="CI/CD, Monorepo">
      <img noZoom src="https://mintcdn.com/aspectbuild/x1L7Iep716jCyJVo/images/blog/hashnode/hn-89d02e6ca2.jpeg?fit=max&auto=format&n=x1L7Iep716jCyJVo&q=85&s=6bb965e49720cb1efbeb65127114c3be" alt="" width="1437" height="958" data-path="images/blog/hashnode/hn-89d02e6ca2.jpeg" />
    </BlogCard>
  </div>
</Section>