Skip to content
bgHub
A background upgrade for your AI coding agent

Let your agent build
backgrounds worth shipping.

bgHub plugs a curated library of real background code into your coding agent. One prompt, and it delivers something stunning, one of a kind and fast, not another flat gradient.

View all backgrounds

FAQs

Is bgHub free? Do I need an account?

It is free, with no account, no sign-in and no API key. Every background is MIT-licensed, so you can ship it in personal and commercial work without attribution, and the source files are served directly over plain HTTP requests.

How do I use bgHub with an AI coding agent?

Install the bgHub skill once, then ask your agent in plain language for the background you want. The skill teaches it to read the pattern index, compose a background slug and download the real source files instead of retyping them. It works with Claude Code, Cursor, Codex and anything else that can run curl.

Can my agent browse the catalogue without the skill?

Yes. /api/patterns lists every pattern with its tech, weight, motions and tags; /api/palettes lists the colour ids; /api/bg/<slug> returns the file manifest with ready-to-run download commands. There is also /llms.txt for agents that prefer a single overview file.

How do I add a background to my project?

Copy the source from the background page or download it with the command shown there, drop it into your components folder, and mount it in a positioned parent behind your content. There is no package to install and no dependency on bgHub at runtime.

Which frameworks are supported?

Each background ships two builds: a React TypeScript component (react-three-fiber where WebGL is involved), and a standalone HTML file that runs by opening it in a browser, with Three.js loaded from a CDN. The HTML build is the starting point for Vue, Svelte, Astro or plain static pages.

Will an animated background slow my site down?

It depends on the technique. Every background is labelled light, medium or heavy so you can judge its runtime cost before you commit. CSS backgrounds are the cheapest and safe almost anywhere; full-screen GLSL shaders are the most demanding, so keep those for pages that already load a WebGL renderer.

Can I change the colours or the speed?

Yes. Each pattern comes in several palettes and motion settings, so pick the closest one on its page first. After that the file is yours: the colours and the animation timings are plain literal values in the source, so nudging them towards a brand palette is an edit, not a rewrite.

Is it accessible on mobile and with reduced motion?

The components are responsive and fill whatever container you give them, but motion and contrast are decisions only you can make for your product. Honour prefers-reduced-motion, check the contrast of text placed on top, and prefer the calmer motions behind body copy.