🏝 Laeva-Animal-Island-UI

Note: This repository is a fork of guokaigdg/animal-island-ui with additional components listed below. All credit for the original design and components belongs to the upstream author.

🚀 What's Different from Upstream

• BidirectionalTypewriter — A bidirectional typewriter component that supports both forward (typing out character by character) and backward (deleting character by character) modes. The API is consistent with Typewriter, controlled via the direction prop.
• ControlledCollapse — A controlled collapse panel component that accepts expanded and onToggle props, enabling external state management. Ideal for accordion-style layouts where only one panel should be open at a time. Visual design is identical to Collapse.

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.

Documentation

Complete reference for different scenarios:

| Document | Purpose | |---|---| | AI_USAGE.md | AI code assistant handbook - all component props, types and defaults word-for-word, 19 hard rules and copy-paste boilerplate, no invented APIs. | | DESIGN_PROMPT.md | One-click reproduction prompts for v0 / Figma AI / Midjourney / DALL-E, including color palette, fonts, size tables, Modal clip-path and prohibition list. | | skill/SKILL.md | Pixel-perfect style specification Skill - design tokens, all component CSS, Demo layout values, CSS variable templates and new component development checklist. | | CONTRIBUTING.md | Contributing Guide |

Notes

• This project is for personal learning, research, and non-commercial demonstration only. Any form of commercial use, resale, or profit-making activities is prohibited.
• Not for use in any commercial products, enterprise projects, external services, or paid templates.
• 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

MIT This project is released under the MIT open-source license, for learning use only. The author is not responsible for any legal issues or losses caused by the use of this library.