explaingit

alibaba/ice

Analysis updated 2026-06-21

★ 18,633TypeScriptAudience · vibe coderComplexity · 3/5LicenseSetup · easy

TLDR

ice.js is a React web framework by Alibaba that works out of the box, no build tool setup needed, with file-based routing, server-side rendering, and TypeScript built in from the start.

Mindmap

mindmap
  root((ice.js))
    What it does
      React framework
      Zero config setup
      File-based routing
    Features
      Server-side rendering
      Static site generation
      Mini-app support
    Tech
      TypeScript
      React
      Plugin system
    Audience
      React developers
      App builders
      Vibe coders
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Start a new React web app with TypeScript, routing, and server-side rendering configured using a single setup command.

USE CASE 2

Build a web app where adding a new file automatically creates a new URL route, with no routing config to write.

USE CASE 3

Add server-side rendering to a React app to improve SEO and initial page load speed without complex setup.

USE CASE 4

Build a WeChat mini-app using familiar React syntax through ice.js mini-app support.

What is it built with?

TypeScriptReactJavaScript

How does it compare?

alibaba/icemountain-loop/yaakconventional-changelog/commitlint
Stars18,63318,61318,522
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasymoderateeasy
Complexity3/53/52/5
Audiencevibe coderdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min
MIT, use freely for any purpose including commercial, with no restrictions beyond keeping the copyright notice.

In plain English

ice.js is a React-based web application framework built by Alibaba that aims to reduce configuration overhead. Instead of manually setting up build tools, routing, and state management, ice.js provides these out of the box with sensible defaults, following a "zero config" philosophy where TypeScript, CSS modules, and other common needs work without additional setup. The framework uses file-system routing, the structure of your files automatically determines the URL routes in your app, so you don't need to write routing configuration manually. It supports server-side rendering (generating pages on the server at request time) and static site generation (pre-building pages at build time), as well as a plugin system for extending functionality. It also supports mini-apps, a format used on platforms like WeChat. A new project can be started with a single command. The framework is MIT-licensed and maintained with community contributions.

Copy-paste prompts

Prompt 1
Create a new ice.js project with TypeScript and file-system routing. Show me the folder structure and how adding a new file in the pages folder automatically creates a new route.
Prompt 2
I have an ice.js app and want to enable server-side rendering for my product listing page to improve SEO. Show me how to configure SSR for that specific page.
Prompt 3
Add a plugin to my ice.js project that enables static site generation for my marketing landing pages. What is the plugin setup and how do I mark which pages should be pre-built at build time?
Prompt 4
Show me how ice.js handles data fetching for server-side rendered pages, where do I write the fetch code and how does the data get passed into my React component as props?

Frequently asked questions

What is ice?

ice.js is a React web framework by Alibaba that works out of the box, no build tool setup needed, with file-based routing, server-side rendering, and TypeScript built in from the start.

What language is ice written in?

Mainly TypeScript. The stack also includes TypeScript, React, JavaScript.

What license does ice use?

MIT, use freely for any purpose including commercial, with no restrictions beyond keeping the copyright notice.

How hard is ice to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is ice for?

Mainly vibe coder.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub alibaba on gitmyhub

Verify against the repo before relying on details.

Alternatives & similar repos