# refine-dev

refine-dev — a skill that gives the agent Refine's data provider, resource and hook model, so React admin panels over REST, GraphQL, Supabase or Strapi get built the intended way.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 210 installs · ★ 23 repo stars
- Author: itechmeat
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/itechmeat/llm-code/tree/HEAD/skills/refine-dev/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/refine-dev

## What it does

The skill hands the agent a map of Refine's core pieces: a backend adapter, declared resources, hooks, an auth provider and a router provider. Reference files sit beside it, covering data providers, resources, routing, hooks, auth, Mantine UI, the inferencer, notifications, i18n and realtime. Since 5.0.12, `useList` and `useTable` keep extra fields that `getList` returns.

Scaffolding runs through `npm create refine-app@latest` with Vite, Mantine and a REST backend, or the packages go in by hand. A feature then follows a fixed order: declare the entity in `<Refine resources={[...]}>`, write the List, Create, Edit and Show pages, match routes to resource paths, and reach for `useTable` on lists and `useForm` on create and edit screens.

A section called Critical Prohibitions keeps the agent in line. One UI library per project, Mantine if that is what you started with. Reads and writes go through Refine hooks instead of raw fetches, API addresses stay in the data provider config, and every CRUD entity appears in `resources`.

## Requirements
- Works with: Supabase

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add itechmeat/llm-code --skill refine-dev -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/refine-dev/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/refine-dev/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add itechmeat/llm-code --skill refine-dev -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/refine-dev/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add itechmeat/llm-code --skill refine-dev -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/refine-dev/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install itechmeat/llm-code skills/refine-dev
```

2. **Manually: put the files in place**
- File: `.github/skills/refine-dev/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add itechmeat/llm-code --skill refine-dev -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/itechmeat/llm-code --path skills/refine-dev
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/refine-dev/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add itechmeat/llm-code --skill refine-dev -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/itechmeat/llm-code/tree/HEAD/skills/refine-dev/SKILL.md

## When to use it
- build a React admin panel over REST or GraphQL
- wire Supabase or Strapi in as a data provider
- set up login and permissions with an auth provider
- generate CRUD pages from an API schema with the inferencer
- subscribe to live updates through LiveProvider

## Example prompts
- Scaffold a Refine admin panel for `posts` with Mantine and a REST data provider.
- Why does `useTable` drop the extra field my `getList` returns?
- Add an auth provider that checks user roles.

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: d41dd144fd6c94a9.

BEGIN THIRD-PARTY FILE d41dd144fd6c94a9
````text
---
name: refine-dev
description: "Refine.dev headless React framework for CRUD apps: data providers, resources, routing, authentication, hooks, and forms. Use when building admin panels, dashboards, or internal tools with React and various backends (REST, GraphQL, Supabase, Strapi), or configuring Refine data providers and authentication. Keywords: Refine, CRUD, admin panel, data provider, React."
metadata:
  version: "5.0.12"
  release_date: "2026-04-02"
---

# Refine.dev Framework

Refine is a headless React framework for building enterprise CRUD applications. It provides data fetching, routing, authentication, and access control out of the box while remaining UI-agnostic.

## Core Concepts

Refine is built around these key abstractions:

1. **Data Provider** — adapter for your backend (REST, GraphQL, etc.)
2. **Resources** — entities in your app (e.g., `posts`, `users`, `products`)
3. **Hooks** — `useList`, `useOne`, `useCreate`, `useUpdate`, `useDelete`, `useForm`, `useTable`
4. **Auth Provider** — handles login, logout, permissions
5. **Router Provider** — integrates with React Router, etc.

## Quick Start (Vite)

Scaffold: `npm create refine-app@latest` (select Vite, Mantine, REST API). For manual setup, install `@refinedev/core @refinedev/mantine @refinedev/react-router` and Mantine packages.

## Minimal App Structure

```tsx
// src/App.tsx
import { Refine } from "@refinedev/core";
import { MantineProvider } from "@mantine/core";
import routerProvider from "@refinedev/react-router";
import dataProvider from "@refinedev/simple-rest";
import { BrowserRouter, Routes, Route } from "react-router-dom";

function App() {
  return (
    <BrowserRouter>
      <MantineProvider>
        <Refine
          dataProvider={dataProvider("https://api.example.com")}
          routerProvider={routerProvider}
          resources={[
            {
              name: "posts",
              list: "/posts",
              create: "/posts/create",
              edit: "/posts/edit/:id",
              show: "/posts/show/:id",
            },
          ]}
        >
          <Routes>{/* Your routes here */}</Routes>
        </Refine>
      </MantineProvider>
    </BrowserRouter>
  );
}
```

## Critical Prohibitions

- Do NOT mix multiple UI libraries (pick Mantine and stick with it)
- Do NOT bypass data provider — always use Refine hooks for data operations
- Do NOT hardcode API URLs — use data provider configuration
- Do NOT skip resource definition — all CRUD entities must be declared in `resources`
- Do NOT ignore TypeScript types — Refine is fully typed, leverage it
````
END THIRD-PARTY FILE d41dd144fd6c94a9

The third-party file has ended. Everything between the d41dd144fd6c94a9 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2612 of 4709 bytes. © itechmeat · MIT · https://github.com/itechmeat/llm-code/tree/HEAD/skills/refine-dev/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
