# Technology Stack

> Technology stack and architectural constraints. Use when choosing technologies, adding dependencies, or understanding zero-dependency requirements.

- Skill: `ag-grid/technology-stack` (Agent Skill)
- Install (CLI): `npx skillmds@latest add ag-grid/technology-stack`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ag-grid/technology-stack/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ag-grid (https://skillmd.com/u/ag-grid)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ag-grid/technology-stack

---


# AG Charts Technology Stack

This document outlines the preferred technologies and architectural constraints for the AG Charts monorepo.

## Critical Requirement: Zero Runtime Dependencies

**The main AG Charts libraries (`ag-charts-core`, `ag-charts-community`, `ag-charts-enterprise`) MUST have ZERO third-party runtime dependencies.** Only internal AG Charts packages and dev dependencies for build/test tooling are allowed.

## Core Libraries

| Package                | Runtime Dependencies                                    | Purpose                                  |
| ---------------------- | ------------------------------------------------------- | ---------------------------------------- |
| `ag-charts-types`      | **NONE** (zero dependencies)                            | TypeScript type definitions              |
| `ag-charts-core`       | `ag-charts-types` only                                  | Core rendering engine and utilities      |
| `ag-charts-locale`     | **NONE** (zero dependencies)                            | Internationalization (40+ languages)     |
| `ag-charts-community`  | `ag-charts-core`, `ag-charts-types`, `ag-charts-locale` | MIT licensed charts library              |
| `ag-charts-enterprise` | `ag-charts-community`, `ag-charts-core`                 | Commercial charts with advanced features |

**Core Technologies:**

-   **TypeScript**: Primary language with strict mode enabled
-   **Canvas API**: Custom high-performance rendering with scene graph
-   **Pure JavaScript**: No external runtime dependencies

## Framework Wrappers

| Package             | Runtime Dependencies           | Peer Dependencies                                      |
| ------------------- | ------------------------------ | ------------------------------------------------------ |
| `ag-charts-react`   | `ag-charts-community`          | `react ^18.0.0 \|\| ^19.0.0`                           |
| `ag-charts-angular` | `ag-charts-community`, `tslib` | `@angular/common >= 17.0.0`, `@angular/core >= 17.0.0` |
| `ag-charts-vue3`    | `ag-charts-community`          | `vue ^3.5.0`                                           |

## Documentation Website (`ag-charts-website`)

| Technology         | Purpose                             |
| ------------------ | ----------------------------------- |
| **Astro** (v5.8.2) | Static site generator               |
| **Markdoc**        | Content authoring for documentation |
| **React**          | Interactive components within Astro |
| **Vite**           | Development server and build tool   |
| **Prism.js**       | Syntax highlighting                 |
| **Algolia**        | Documentation search                |
| **Nanostores**     | Lightweight state management        |
| **Cheerio**        | Server-side HTML parsing            |

## Development & Build Tools

| Tool                    | Purpose                            | Used By            |
| ----------------------- | ---------------------------------- | ------------------ |
| **Nx** (v20.3.1)        | Monorepo orchestration and caching | All packages       |
| **TypeScript** (v5.4.5) | Type checking and compilation      | All packages       |
| **SWC**                 | Fast transpilation                 | Build system       |
| **ESBuild**             | High-performance bundling          | Production builds  |
| **Jest**                | Unit testing with visual snapshots | Core libraries     |
| **Playwright**          | E2E testing                        | Website            |
| **Vitest**              | Fast unit testing                  | Website components |
| **ESLint**              | Code linting with custom rules     | All packages       |
| **Prettier**            | Code formatting                    | All packages       |
| **Size Limit**          | Bundle size monitoring             | Core libraries     |

## Version Requirements

-   **Node.js**: ^22.21.1
-   **Yarn**: ^1.22.21
-   **Build Target**: ES2020 (excludes IE)
-   **TypeScript**: Strict mode enabled across all packages