For the complete documentation index, see llms.txt. Markdown variants are available by appending .md to any URL or sending an Accept: text/markdown header. An agent skill is available at /.well-known/agent-skills/site-skill.md.
FrakmentFrakment

Remix

Install and configure Frakment for Remix.

Frakment works in any Remix 2+ project with React 19 and Tailwind v4. This guide covers both a new project via the CLI and an existing app.

Prerequisites

  • Remix 2 or newer
  • React 19
  • TypeScript
  • Tailwind CSS v4

Components target React 19 and Tailwind v4. For React 18, some components need forwardRef adjustments. For Tailwind v3, port the tokens from Theming manually.

Use the CLI

Scaffold a new Remix app with Frakment installed.

Create project

$ npx create-remix@latest app
cd app

Install Tailwind v4

$ npm install tailwindcss@latest @tailwindcss/vite

Register the Vite plugin:

vite.config.ts
import { vitePlugin as remix } from "@remix-run/dev";
import tailwindcss from "@tailwindcss/vite";
import { defineConfig } from "vite";
 
export default defineConfig({
  plugins: [remix(), tailwindcss()],
});

Add components

$ npx frakment@latest init
npx frakment@latest add bubble

Use it

app/routes/_index.tsx
import { Bubble, BubbleContent } from "@/components/ui/message";
 
export default function Index() {
  return (
    <Bubble>
      <BubbleContent>Hello, Frakment.</BubbleContent>
    </Bubble>
  );
}

Existing Project

Add Frakment to a Remix app you already created.

Install Tailwind v4

$ npm install tailwindcss@latest @tailwindcss/vite

Register the Vite plugin:

vite.config.ts
import { vitePlugin as remix } from "@remix-run/dev";
import tailwindcss from "@tailwindcss/vite";
import { defineConfig } from "vite";
 
export default defineConfig({
  plugins: [remix(), tailwindcss()],
});

Run frakment init

$ npx frakment@latest init

Point to app/tailwind.css when prompted. The CLI injects the theme block after your imports.

Configure the import alias

In tsconfig.json:

tsconfig.json
{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@/*": ["./*"]
    }
  }
}

Add a component

$ npx frakment@latest add bubble

Project structure

package.json
Vitevite.config.ts
tsconfig.json
root.tsx
tailwind.css
_index.tsx

Verify

ls app/components/ui/bubble.tsx

Then render it in a route. If it renders without errors, you are ready.

Troubleshooting

Make sure @tailwindcss/vite is registered in vite.config.ts and restart the dev server. Vite caches the plugin list in memory.

Check tsconfig.json paths and the aliases in components.json. Both must match.

Next