---
# System prepended metadata

title: Repo and team structure
tags: [wiki]

---

---
robots: nofollow, noindex
tags: wiki
---

# Repo and team structure

[toc]

(see also [RFC: Communicating new Package Structure for @fluentui/](/P5T_Br4hSZC18nBCinHkww))

## Folders
Moved to https://github.com/microsoft/fluentui/wiki/Fluent-UI-React-Repo-Structure#folders

## Relevant published packages

Moved to https://github.com/microsoft/fluentui/wiki/Fluent-UI-React-Repo-Structure#relevant-published-packages

## Other packages

### `apps`

Tests, demos, etc. Currently only contains stuff related to v8 (not northstar). None of these are published since they're generally not useful outside this repo. (The doc site was a published package in `7.0` due to an internal site building on it, but that's not longer happening.)

| Folder (under `apps`) | Description |
| --- | --- |
| `a11y-tests` | Automated a11y tests, currently disabled |
| `codesandbox-react-northstar-template` | Codesandbox template for `@fluentui/react-northstar`, deployed by codesandbox CI for each PR |
| `codesandbox-react-template` | Codesandbox template for `@fluentui/react`, deployed by codesandbox CI for each PR |
| `dom-tests` | Tests using the browser via Puppeteer (never finished) |
| **`perf-test`** | Perf tests for individual components. Used for the perf comment on PRs. |
| **`pr-deploy-site`** | Bootstrapping for demo site deployed for each PR |
| **`public-docsite`** | public website, https://developer.microsoft.com/fluentui (`7.0` name: `fabric-website`) |
| `public-docsite-resources` | Legacy demo app bootstrapping, used for aka.ms/fluentdemo (`7.0` name: `fabric-website-resources`) |
| `server-rendered-app` | Sample server-rendered app |
| `ssr-tests` | Very basic server rendering tests for each component |
| **`test-bundles`** | Bundle size calculations used in Size Auditor PR comment |
| `theming-designer` | Custom theme designer, https://aka.ms/themingdesigner |
| `todo-app` | Demo todo app, currently outdated (Elizabeth has a nearly finished updated version) |
| **`vr-tests`** | Screener visual tests |



## Internal structure of a built package

### `packages/!(fluentui|web-components)`

This applies to most packages under `packages/*` (excluding `packages/fluentui/*` which will be discussed later). Not all files or folders are present for all packages.
```
config/
  api-extractor.json  API Extractor config for component package
  tests.js            Jest test setup file

dist/                 Generated by build and bundle
  <pkg>.api.json      API Extractor metadata for package
  <pkg>.d.ts          Typings rollup
  <pkg>.js            UMD bundle of package (webpack output)

etc/
  <pkg>.api.md        API Extractor report of pkg's public APIs

lib/                  Built files, ESM format for component/browser packages
                      (or commonjs format for build utilities). Same structure as src/

lib-commonjs/         Component/browser packages only: built files in
                      commonjs format (mainly for use with Jest)

lib-amd/              Component/browser packages only: built files in
                      AMD format (prod builds only)

src/
  components/        Where applicable
    Foo/             Exact component files vary
      Foo.ts
      Foo.base.tsx   Mainly for legacy components? (react, react-internal)
      Foo.types.ts
      Foo.styles.ts  Mainly for legacy components
```

### `packages/fluentui/*`

These are packages related to `@fluentui/react-northstar` which use a different structure.

### `packages/web-components`

This is an almost entirely separate package containing web components. It's maintained by a separate team (mgr: Chris Holt) and uses a separate build system and sometimes separate dependency versions. (In the repo root package.json there's a `workspaces.nohoist` config to ensure that potentially-conflicting deps are installed only under `packages/web-components` and not at the repo root.)


## Config files and build system

https://microsoft.github.io/just/
https://microsoft.github.io/beachball/
https://microsoft.github.io/lage/



## Docs and demo pages

- Docs and demos
  - v7/8
    - https://developer.microsoft.com/fluentui - official doc site
    - https://aka.ms/fluentdemo - demo site for all 6/7/8 versions (good for tracing when a regression happened)
  - v0 (northstar)
    - https://aka.ms/fluent-ui (note the dash) - doc site
  - all
    - http://fabricweb.z5.web.core.windows.net/pr-deploy-site/refs/heads/master/ - PR deploy site but for master
- Templates v7/8
  - https://aka.ms/fluentpen - codepen
  - https://aka.ms/fluentsandbox - codesandbox

## People

See [onenote](onenote:https://microsoft.sharepoint-df.com/teams/FluentUIInternal/Shared%20Documents/General/Fluent%20UI%20Facts/General.one#People&section-id={4615F82D-3BAE-4855-82AF-D8C766D8FC64}&page-id={B6A4D66C-48CD-AA4E-B850-CD3088AAE68F}&end) ([web view](https://microsoft.sharepoint-df.com/teams/FluentUIInternal/_layouts/OneNote.aspx?id=%2Fteams%2FFluentUIInternal%2FShared%20Documents%2FGeneral%2FFluent%20UI%20Facts&wd=target%28General.one%7C4615F82D-3BAE-4855-82AF-D8C766D8FC64%2FPeople%7CB6A4D66C-48CD-AA4E-B850-CD3088AAE68F%2F%29))
