terra-os

As a hobbyist, I want a clear flash guide page so that I can download the correct firmware and follow step-by-step instructions to flash my ESP32-C5 device successfully. Implement based on the existing Flash Guide (v2) JSX design. Reached from the Landing page, leads to the Web DE.

As a developer or hobbyist, I want to access a web-based desktop environment page so that I can launch and interact with the terra-os desktop interface from my browser. Implement based on the existing Web DE (v2) JSX design. Links from Landing and Flash Guide; connects to Plugins, Network Tools, Serial Interface, Plugin SDK, and the AI assistant.

As a hobbyist, I want a network tools page with deauthentication and evil portal controls so that I can run network operations directly from the terra-os web interface. Implement based on the existing Network Tools (v2) JSX design. Accessible from the Web DE.

As a developer, I want a plugin SDK page with API documentation and plugin creation guidance so that I can build and test Python-based plugins for terra-os. Implement based on the existing Plugin SDK (v2) JSX design. Accessible from the Web DE; leads to the Plugins page for uploading created plugins.

As a developer, I want a serial interface page so that I can view debug output and communicate with my ESP32-C5 device over a serial connection from the browser. Implement based on the existing Serial Interface (v2) JSX design. Accessible from the Web DE; serves as the final debug step in the developer flow.

As a hobbyist, I want backend endpoints that serve firmware download links and flash guide metadata so that I can retrieve the correct firmware version and step-by-step instructions for my ESP32-C5 device.

As a user of the Web DE, I want an AI assistant powered by GPT 5.2 so that I can receive intelligent, user-friendly responses to queries about my terra-os device and plugins directly within the desktop environment.

As a hobbyist or developer, I want to browse, install, upload, and test plugins from a dedicated plugins page so that I can extend the functionality of my terra-os device. Implement based on the existing Plugins (v2) JSX design. Accessible from the Web DE.

As a developer, I want the serial interface page connected to the Serial Interface API so that I can send commands and view live debug output from my ESP32-C5 device in the browser.

As a hobbyist or developer, I want the plugins page connected to the Plugin Management API so that I can browse, install, upload, and test plugins with live data from the backend.

As a backend system, I want serial communication endpoints so that the frontend serial interface page can establish, read from, and write to a serial connection with the ESP32-C5 device in real time via WebSocket or polling.

As a backend system, I want API endpoints for deauthentication and evil portal operations so that the frontend network tools page can trigger and monitor these functions on connected ESP32-C5 devices. Must include authentication checks for sensitive operations.

As a hobbyist, I want the network tools page integrated with the Network Tools API so that deauthentication and evil portal operations are triggered and monitored in real time from the browser.

As a developer, I want API endpoints that expose SDK documentation content and validate plugin packages so that I can programmatically access API docs and verify plugins before publishing to the plugin registry.

As a backend system, I want CRUD endpoints for plugin upload, listing, installation, and testing so that the frontend can manage Python-based plugins and developers can publish new plugins to the platform. Includes plugin metadata storage in MySQL.

As a developer or hobbyist using the Web DE, I want the desktop environment page wired to backend APIs and the AI assistant so that all Web DE features including plugin management and AI responses are fully functional with live data.