---
description: Package taxonomy (consumer view) -- external projects consume the published @elevasis/* surface only; workspace-internal @repo/elevasis-* packages are not installable here
---
<!-- @generated by packages/sdk/scripts/copy-reference-docs.mjs -- DO NOT EDIT -->
<!-- Regenerate: pnpm scaffold:sync -->


# Package Taxonomy (Consumer View)

External projects consume the **published `@elevasis/*` surface only**. The Elevasis monorepo also has workspace-internal `@repo/elevasis-*` packages — those are NOT installable here and should never appear in your imports or `package.json`.

## What You Can Import

| Package          | Subpaths                                     | Where it lives in `node_modules` |
| ---------------- | -------------------------------------------- | -------------------------------- |
| `@elevasis/sdk`  | default, `/worker`, `/node`, `/test-utils`   | `node_modules/@elevasis/sdk/`    |
| `@elevasis/ui`   | default, `/auth`, `/initialization`, etc.    | `node_modules/@elevasis/ui/`     |
| `@elevasis/core` | `/organization-model`, `/entities`, `/utils` | `node_modules/@elevasis/core/`   |

## What You Will See in Monorepo Docs (and should NOT import)

Monorepo source and docs reference `@repo/elevasis-core` and `@repo/elevasis-operations`. These are workspace-internal packages used by Elevasis as a tenant of its own platform. They are `private: true` and never published. If you see them mentioned:

- Do NOT add them to this project's `package.json`
- Do NOT try to import from them — they are not in your `node_modules`
- They are not a substitute for `@elevasis/core` even though the name overlaps

## Confused About Where Something Lives?

Check the import path:

- `@elevasis/...` → published, consumable here
- `@repo/...` → monorepo-internal, not consumable

This project's own org-model and workflows live in `core/config/organization-model.ts` and `operations/src/**` — those are project-owned, not part of either family above.

## References

- `node_modules/@elevasis/sdk/reference/scaffold/index.mdx` — full SDK scaffold reference
- Monorepo source rule: `.claude/rules/package-taxonomy.md` in the elevasis-monorepo (when working across both)
