@fias/arche-sdk

The runtime SDK for building plugin arches on the FIAS platform. Provides React hooks, a sandboxed iframe bridge, and the in-app purchase / Vault / asset library / image generation surfaces a plugin needs at runtime.

Quick Start

Scaffold a new plugin:

npx create-fias-plugin my-plugin
cd my-plugin
npm install
npm start

Wrap your app in <FiasProvider>:

import { FiasProvider, useFiasTheme } from '@fias/arche-sdk';

function App() {
  const theme = useFiasTheme();
  if (!theme) return null;
  return <div style={{ color: theme.colors.text }}>Hello, plugin!</div>;
}

ReactDOM.createRoot(document.getElementById('root')!).render(
  <FiasProvider>
    <App />
  </FiasProvider>,
);

Full developer guide

The complete plugin-development reference — every hook, the manifest schema, IAP, Vault, the asset library, permission scopes, sandbox constraints, and submission workflow — ships with this package at:

./templates/default/CLAUDE.md

This file is the canonical AI-readable plugin guide and is identical to the CLAUDE.md / AGENTS.md written into newly scaffolded projects. Open it inside your node_modules/@fias/arche-sdk/templates/default/CLAUDE.md after install.

Keeping an existing project current

npx fias-dev sync

Updates CLAUDE.md, AGENTS.md, .cursorrules, and .github/copilot-instructions.md in your project from the latest SDK templates. Never touches package.json, fias-plugin.json, or src/.

Related docs

• docs/arche-guide.md — step-by-step guide for arche / plugin creation.
• docs/api-plugins.md — server-side submission, review pipeline, and bridge API reference.

License

MIT