ng-zorro-antd

An enterprise-class UI components based on Ant Design and Angular 7. ?

Github stars Tracking Chart

An enterprise-class UI components based on Ant Design and Angular.

Azure branch
CodeFactor
Codecov
GitHub Release Date
npm package
NPM downloads
GitHub license
Gitter
extension-for-VSCode
code style: prettier
Twitter

English, 简体中文

✨ Features

  • An enterprise-class UI design system for web applications.
  • A set of high-quality Angular components out of the box.
  • Written in TypeScript with predictable static types.
  • The whole package of development and design resources and tools.
  • Support OnPush mode, high performance.
  • Support Customize theme.
  • Support import Component individually.

? Environment Support

  • Angular ^8.0.0
  • Server-side Rendering
  • Modern browsers and Internet Explorer 11+ (with polyfills)
  • Electron, IE / Edge, Firefox, Chrome, Safari, Opera, Electron, ---------, ---------, ---------, ---------, ---------, ---------, IE11, Edge, last 2 versions, last 2 versions, last 2 versions, last 2 versions, last 2 versions

Listing @angular/cdk as its dependency, ng-zorro-antd supports the most recent two versions of all major browsers.

? Design Specification

ng-zorro-antd synchronizes design specification with Ant Design on a regular basis, you can check the log online.

? Installation

We recommend using @angular/cli to install. It not only makes development easier, but also allows you to take advantage of the rich ecosystem of angular packages and tooling.

$ ng new PROJECT_NAME
$ cd PROJECT_NAME
$ ng add ng-zorro-antd

More information about @angular/cli here.

You can also install ng-zorro-antd with npm or yarn

$ npm install ng-zorro-antd

? Usage

Import the component modules you want to use into your app.module.ts file and feature modules.

import { NzButtonModule } from 'ng-zorro-antd/button';

@NgModule({
  imports: [ NzButtonModule ]
})
export class AppModule {
}

@angular/cli users won't have to worry about the things below but it's good to know.

And import style and SVG icon assets file link in angular.json.

{
  "assets": [
+   {
+     "glob": "**/*",
+     "input": "./node_modules/@ant-design/icons-angular/src/inline-svg/",
+     "output": "/assets/"
+   }
  ],
  "styles": [
+   "node_modules/ng-zorro-antd/ng-zorro-antd.min.css"
  ]
}

See Getting Started for more details.

⌨️ Development

$ git clone git@github.com:NG-ZORRO/ng-zorro-antd.git
$ cd ng-zorro-antd
$ npm install
$ npm run start

Browser would open automatically.

? Road Map

Check this issue to read our plans for 2019.

? Contributing

PRs Welcome

We welcome all contributions. Please read our CONTRIBUTING.md first. You can submit any ideas as pull requests or as GitHub issues.

If you're new to posting issues, we ask that you read How To Ask Questions The Smart Way (This guide does not provide actual support services for this project!), How to Ask a Question in Open Source Community and How to Report Bugs Effectively prior to posting. Well written bug reports help us help you!

Thanks to JetBrains for supporting us free open source licenses.

JetBrains

❓ Help from the Community

For questions on how to use ng-zorro-antd, please post questions to using the ng-zorro-antd tag. If you're not finding what you need on stackoverflow, you can find us on Gitter as well.

As always, we encourage experienced users to help those who are not familiar with ng-zorro-antd!

? Users

We list some users here, if your company or product uses NG-ZORRO, let us know here!

☀️ License

MIT

Main metrics

Overview
Name With OwnerNG-ZORRO/ng-zorro-antd
Primary LanguageTypeScript
Program languageShell (Language Count: 5)
Platform
License:MIT License
所有者活动
Created At2017-08-08 14:59:33
Pushed At2025-06-10 10:05:23
Last Commit At2025-06-10 12:05:23
Release Count169
Last Release Name19.3.1 (Posted on )
First Release Name0.5.0-rc.0 (Posted on )
用户参与
Stargazers Count9k
Watchers Count241
Fork Count4k
Commits Count3.1k
Has Issues Enabled
Issues Count5084
Issue Open Count825
Pull Requests Count3038
Pull Requests Open Count74
Pull Requests Close Count778
项目设置
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private