---
name: ice
summary: "ice.js is Alibaba's universal React-based application framework offering zero-config builds, file-system routing, built-in state management and data fetching, and hybrid SSR/SSG rendering, extensible through a plugin system and able to target web, mini-programs, and Weex."
language: TypeScript
license: MIT
repo: https://github.com/alibaba/ice
source: https://opensources.dev/resource/ice
health: 92
---

# ice

ice.js is Alibaba's universal React-based application framework offering zero-config builds, file-system routing, built-in state management and data fetching, and hybrid SSR/SSG rendering, extensible through a plugin system and able to target web, mini-programs, and Weex.

# ice.js

A universal framework based on React.js, [📚 Docs](https://ice.work/).

## Features

- 🐒 **Zero Config**: Out of the box support for ES6+, TypeScript, Less, Sass, CSS Modules，etc
- 🐯 **Practice**: Practice about file-system routing, state Management, request, etc
- 🦁 **Hybrid**: pre-render pages at build time (SSG) or request time (SSR) for default
- 🐌 **Plugin system**: The plugin system provides rich features and allow the community to build reusable solutions
- 🐂 **Multi-End**: Support both web, miniapp and Weex

## Quick start

We recommend creating a new ice.js app using create-ice, which sets up everything automatically for you. To create a project, run:

```bash
$ npm init ice ice-app --template @ice/lite-scaffold
```

`npm init <initializer>` is available in npm 6+

Start local server to launch project:

```bash
$ cd ice-app
$ npm install
$ npm run start # running on http://localhost:3000.
```

It's as simple as that!

## Contributing

Please see our [CONTRIBUTING.md](/.github/CONTRIBUTING.md)

## Contributors

Contributors can contact us to join the Contributor Group.

## Community

- [Issues](https://github.com/alibaba/ice/issues)
- [Gitter](https://gitter.im/alibaba/ice)

## LICENSE

[MIT](https://github.com/alibaba/ice/blob/master/LICENSE)