中文

aily blockly Libraries

This repository contains Blockly libraries for the aily blockly visual programming platform, providing extensive hardware and functionality extensions.

Features

• 🧩 Rich Ecosystem - 300+ libraries
• 🌍 Multilingual - Internationalization support for 11 languages
• 🤖 AI-Friendly - README_AI.md for LLM understanding and usage
• 🔧 Compliance Checking - Built-in GitHub Actions for library validation

Quick Start

Install a Library

In your aily blockly project terminal:

npm i @aily-project/lib-library-name

Develop a Library

1. Fork this repository
2. Create a new library following the structure
3. Submit a Pull Request

Library Structure

library-name/
├── block.json        # Block definitions
├── generator.js      # Arduino code generator
├── toolbox.json      # Toolbox configuration
├── package.json      # npm package config
├── readme.md         # User documentation
├── readme_ai.md      # AI documentation (optional)
├── src.7z            # Arduino library source (7z compressed)
└── i18n/             # Internationalization
    ├── zh_cn.json
    ├── en.json
    └── ...

Documentation

Document	Description
Library Standards	Blockly library development standards
Development Guide	Development, debugging and submission
Internationalization	i18n configuration guide
Contributing Guide	Contribution guidelines
Private Deployment	Private npm registry setup
Test Status	Library test status
Roadmap	Planned libraries

Developer References

Document	Description
Blockly Library Code Conventions	Code conventions for Blockly libraries
Blockly Library README Standards	README documentation standards
i18n File Standards	Detailed i18n spec

Contributing

Contributions are welcome!

1. Fork this repository
2. Create a feature branch: git checkout -b feature/my-new-lib
3. Commit changes: git commit -m 'feat: add my-new-lib'
4. Push to branch: git push origin feature/my-new-lib
5. Submit a Pull Request

See Contributing Guide for details.

License

Each library follows its original open-source license. See the documentation in each library directory.