🏝 Animal-Island-UI

<img src="https://github.com/guokaigdg/animal-island-ui/raw/v1.1.1/docs/img/readme-home.png" alt="animal-island-ui" style="border-radius: 12px; width: 40%; display: block; margin: 0 auto;" />

A React UI component library inspired by Animal Crossing: New Horizons

<a href="https://github.com/guokaigdg/animal-island-ui/stargazers"><img src="https://img.shields.io/github/stars/guokaigdg/animal-island-ui?style=flat-square" alt="Stars"></a>
<a href="https://github.com/guokaigdg/animal-island-ui/raw/v1.1.1/LICENSE"><img src="https://img.shields.io/badge/license-CC--BY--NC--4.0-orange.svg?style=flat-square" alt="License: CC BY-NC 4.0"></a>
<a href="https://github.com/guokaigdg/animal-island-ui/raw/v1.1.1/LICENSE"><img src="https://img.shields.io/npm/dm/animal-island-ui.svg?style=flat-square" alt=""></a>
<a href="https://github.com/guokaigdg/animal-island-ui/releases"><img src="https://img.shields.io/github/v/tag/guokaigdg/animal-island-ui?label=version&style=flat-square" alt="Version"></a>
<a href="https://gitcode.com/guokaigdg/animal-island-ui"><img src="https://gitcode.com/guokaigdg/animal-island-ui/star/badge.svg" alt="Stars"></a>



<a href="https://github.com/guokaigdg/animal-island-ui/raw/v1.1.1/coverage/badges/coverage.json"><img src="https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/guokaigdg/animal-island-ui/main/coverage/badges/coverage.json&style=flat-square" alt="Coverage"></a>
<img src="https://img.shields.io/badge/tests-332%20✓-brightgreen?style=flat-square" alt="Tests">
<img src="https://img.shields.io/badge/components-26-blue?style=flat-square" alt="Components">
<img src="https://img.shields.io/badge/a11y-WAI--ARIA%20APG-brightgreen?style=flat-square" alt="Accessibility">









<a href="https://hellogithub.com/repository/guokaigdg/animal-island-ui" target="_blank"><img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=98ecff41d142466d8d72694a6fadf9e9&claim_uid=pyGqTPIRMdo7fBS&theme=neutral" alt="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>










English | <a href="https://github.com/guokaigdg/animal-island-ui/raw/v1.1.1/docs/README.zh-CN.md">简体中文</a>

Introduction

This project is a lightweight UI component library built with React + TypeScript. The design style is inspired by Nintendo's "Animal Crossing: New Horizons" game interface, created for personal front-end technical practice and component development learning.

All visual elements, layouts, icons, and animations are independently designed and implemented, without directly using any official Nintendo art materials, code, or resource files.

🎉 Vue Version

• animal-island-vue

Preview

• Online Preview (PC) animal-island-ui-pc
• Online Preview (Mobile) animal-island-ui-mobile

🚀 Use AI to Generate animal-island-ui Pages (No Coding Needed)

Non-developer and don't want to write code yourself? Use PROMPT.md — no npm, no build step.

4 steps:

1. Copy PROMPT.md in full.
2. Paste into any AI tool (Cursor / Claude / ChatGPT / Gemini / DeepSeek) and send.
3. The AI asks what page you want — reply in one phrase (e.g. "personal blog", "product list", "FAQ").
4. Save the index.html it returns and double-click to preview.

Installation

npm install animal-island-ui

Quick Start

⚠️ Important: Please make sure to import the styles with import 'animal-island-ui/style', otherwise the components will have no styles or fonts!

import { Button, Card } from 'animal-island-ui';
import 'animal-island-ui/style';

function App() {
    return (



            <Button type="primary">Start Adventure</Button>
            <Card color="app-blue">Welcome to the deserted island!</Card>



    );
}

Documentation

Complete reference for different scenarios:

Local Development

# Clone the repository
git clone https://github.com/guokaigdg/animal-island-ui.git
cd animal-island-ui

# Install dependencies
npm install

# Start Demo development server
npm run dev

# Build component library
npm run build

# Build Demo site
npm run build:demo

Usage Cases

Animal Island New Tab Animal Crossing style new tab page	ac-site-template Animal Crossing themed personal website template	HiKid English learning app for children
AnimalIslandUI Animal Crossing style Android UI library	ItbugShop Liang Diandian's Blog	KidsMathQuest Math practice for elementary school
animal_island_flutter Animal Crossing style Flutter UI library	animal-island-blog Animal Crossing style blog	Island Life Journal Island Life Photo Journal
Animal Crossing BGM Player ambience clock + hourly music	animal-island-ui-taro-port Taro & WeChat Mini Program	portal-os Animal desktop blog
Awesome-splatoon3 Splatoon 3 resource station

Notes

• This project is intended for personal learning, research, and non-commercial demonstration only. Any form of commercial use, resale, or profit-making activities is prohibited.
• Not to be used in any commercial product, enterprise project, external service, or paid template.
• Users are solely responsible for any risks arising from the use of this component library.

Copyright and Disclaimer

• This project is not an official Nintendo product and has no association, authorization, or cooperation with Nintendo Co., Ltd.
• The game name included in the project name is only a descriptive reference to the style and does not constitute trademark use or brand association.
• All interface styles are merely design inspiration references and do not constitute reproduction or infringement of the original work.
• If the copyright holder believes that related content is suspected of infringement, they can contact via email, and I will make rectifications or deletions immediately.

Contact

For any questions or copyright-related communications, please contact via Issue or email.

License

Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) — see the LICENSE file for the full text.

• Commercial use: PROHIBITED.
• Permitted (non-commercial): personal learning, research, evaluation, testing, and non-commercial display.
• Attribution required: must retain the original copyright notice and license declaration.
• The author is not responsible for any legal issues or losses caused by the use of this library.