中文

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

License

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