[O/S]πŸš€ BlockLens - Advanced AIA Viewer & AIX Analyzer

:rocket: BlockLens - Advanced AIA Viewer & AIX Analyzer

Version

Hello Community! :wave:

I am excited to share BlockLens, a powerful, open-source web tool designed to help you analyze, view, and document your App Inventor, Kodular, and Niotron projects without needing to import them into the builder.

This tool is built upon the original ai-unchive library but has been significantly supercharged with features specifically for extension developers and power users.


:star2: What is BlockLens?

BlockLens allows you to:

  1. View AIA Projects: Explore screens, blocks, and assets of any .aia file.

  2. Analyze AIX Extensions: Drag & drop an .aix file to see all its internals (methods, events, properties).

  3. Generate Documentation: Auto-generate beautiful Markdown documentation for your extensions.

  4. Export Blocks: Download high-quality PNGs of your blocks for tutorials or documentation.


:sparkles: Key Features

1. :open_file_folder: Project Viewer (AIA)

  • Screen Explorer: Navigate through all screens in your project.

  • Block Viewer: View all your logic blocks with high-fidelity rendering (uses MIT App Inventor Blockly).

  • Asset Manager: Organize and preview project assets.

  • Export Blocks: Download high-quality PNGs of Separate blocks for tutorials or documentation.

  • Page Layout: View all your page layouts in List View and Grid View.

  • Block Scale: Zoom in and out of blocks on Fingers Scale.

2. :jigsaw: Extension Analyzer (AIX)

Stop guessing what an extension does! Upload the .aix via BlockLens and see:

  • Events, Methods, & Properties: Neatly organized with type information.

  • Smart Helpers: It even renders dropdown helpers for property blocks, just like in the builder.

  • Theme Switcher: View blocks in App Inventor, Kodular, or Niotron color themes!

  • Bulk Export - Download full documentation (Markdown + Images) as a ZIP file

  • Auto Documentation - Generate professional markdown docs with one click

3. :memo: Documentation Generator (For Developers)

Extension developers, this is for you!

  • One-Click Docs: Generate a full README.md ready for GitHub.

  • Block Images: Automatically generates and zips PNG images of all your blocks.

  • Preview vs Raw: Toggle between a rendered preview and raw Markdown code.


:hammer_and_wrench: How to Use

Viewing a Project (.aia)

  1. Go to BlockLens Live Demo.

  2. Drag and drop your .aia file.

  3. Use the left sidebar to navigate Screens and Assets.

Generating Extension Docs (.aix)

  1. Open BlockLens.

  2. Upload your .aix extension file.

  3. The tool will display all blocks.

  4. Click "Full Docs" in the top right to download a ZIP containing:

  • documentation.md (Formatted text)

  • blocks/ folder (High-quality PNGs of every block)


:art: Professional Themes

We support multiple block styles to match your favorite builder:

  • :orange_square: App Inventor (Classic Gold/Yellow)

  • :purple_square: Kodular (Modern Purple/Blue)

  • :green_square: Niotron (Vibrant Green/Android)


Screenshots

Here








:new: What's New in v1.1.0?

Summary
  • Detailed Helper Loading: Now supports rendering helper blocks (dropdowns) within the documentation preview.

  • Professional UI: Enhanced "Download Summary" button and custom scrollbars for a premium feel.

  • Mobile Ready: Fixed layout issues for seamless use on smartphones and tablets.

  • High-Res Export: Improved PNG export quality for blocks.

  • AIA Png Export: Download full documentation (Project Summary + Blocks Images) as a ZIP file

Bug Fixes

  • Summary Download Button working properly(Download full documentation (Project Summary + Blocks Images) as a ZIP file)

  • Fixed issue where some blocks were not rendering correctly in the documentation.

  • Resolved mobile overflow issues in documentation tables.

  • Helper blocks names are now visible in documentation Block image.

:globe_with_meridians: Open Source & Credits

This project is fully open source!

Feedback and contributions are welcome! :rocket:

Thank

@TechHamara

4 Likes

Nice tool to have, areas for improvement:

  • downloaded block images lack draggability.
  • downloaded blocks file names could include procedure/event/global name for easier identification in directory
  • bulk download would be nice, like AI2Helper browser extension, with option to continue without asking at each download
  • Project Properties not covered, stubs in Screen1 don't show their values (Show Lists as JSON)

(added to FAQ)

2 Likes

Your work is excellent. However, this tool requires a few more refinements to achieve perfection.

Bugs that I found:

  • The component name is not displayed in the blocks.
  • The setter and getter blocks are appearing together.
1 Like

Very nice...If we can perform live testing of project in various android versions with logs for errors then it will become powerful and most useful tool for everyone, & can be monetized as well.

1 Like


:new: What's New in v1.1.0?

  • Detailed Helper Loading: Now supports rendering helper blocks (dropdowns) within the documentation preview.

  • Professional UI: Enhanced "Download Summary" button and custom scrollbars for a premium feel.

  • Mobile Ready: Fixed layout issues for seamless use on smartphones and tablets.

  • High-Res Export: Improved PNG export quality for blocks.

  • AIA Png Export: Download full documentation (Project Summary + Blocks Images) as a ZIP file

Bug Fixes

  • Summary Download Button working properly(Download full documentation (Project Summary + Blocks Images) as a ZIP file)

  • Fixed issue where some blocks were not rendering correctly in the documentation.

  • Resolved mobile overflow issues in documentation tables.

  • Helper blocks names are now visible in documentation Block image.

Summar of Requested Bug fixed:

and

  • work and scroll block on there container.
  • fixed and also download summary with all block images as zip file.
  • work on extension docs :point_up_2:
1 Like


No block images show in Brave browser for the attached Project.

aia blocks load on edge browser. but i've also see some component blocks proper not load.