# Stacks Registry

> Use when working with the Stacks extension registry - framework extension metadata, package discovery, or the registry system. Covers @stacksjs/registry.

- Skill: `stacksjs/stacks-registry` (Agent Skill)
- Install (CLI): `npx skillmds@latest add stacksjs/stacks-registry`
- Raw SKILL.md: https://api.skillmd.com/api/skills/stacksjs/stacks-registry/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- License: MIT
- Author: stacksjs (https://skillmd.com/u/stacksjs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/stacksjs/stacks-registry

---


# Stacks Registry

## Key Paths
- Core package: `storage/framework/core/registry/src/`
- Config: `config/stacks.ts`
- Package: `@stacksjs/registry`

## Source Files
```
registry/src/
└── index.ts              # Registry definition and exports
```

## API

```typescript
import { registry } from '@stacksjs/registry'
import type { Registry } from '@stacksjs/registry'

type Registry = StackExtensionRegistry

const registry: Registry = [
  {
    name: 'stacks',
    url: 'stacksjs.com',
    github: 'stacksjs/stacks',
  },
]

export default registry
```

The registry is a simple array of `StackExtensionRegistry` entries containing framework extension metadata — name, URL, and GitHub repository.

## Usage

```typescript
import { registry } from '@stacksjs/registry'

// Access extension metadata
registry.forEach(ext => {
  console.log(ext.name, ext.url, ext.github)
})
```

## Gotchas
- **Minimal package** — currently just a static array with the core Stacks framework entry
- **Type comes from `@stacksjs/types`** — `StackExtensionRegistry` is defined in the types package
- **Used for framework metadata** — not a package manager or dependency registry
- **Config in `config/stacks.ts`** — the `StackExtensionRegistry` config is defined there