Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Rename PodOS Browser apps to tools #79

Open
angelo-v opened this issue Apr 6, 2025 · 0 comments
Open

Rename PodOS Browser apps to tools #79

angelo-v opened this issue Apr 6, 2025 · 0 comments

Comments

@angelo-v
Copy link
Contributor

angelo-v commented Apr 6, 2025

It is confusing that there are two level of apps like PodOS Browser and PodOS Contacts vs. generic app, container contents etc within PodOS Browser.

Suggestion: Differ between Apps, Tools and Elements


In PodOS, the system is composed of three primary components: Apps, Tools, and Elements. These terms are carefully chosen to distinguish between the high-level apps, reusable tools/components, and smaller UI building blocks.

  1. Apps

Apps are the top-level user-facing applications within PodOS. They represent complete, functional applications that allow users to interact with their data.

Example: PodOS Browser, PodOS Contacts

Apps can incorporate one or more Tools to manage data and provide specific functionality to the user.

  1. Tools

Tools are interactive, web-component-based units that provide functionality for specific tasks within an App. Tools are highly reusable and can be used across different apps to manage or display data.

Example: pos-tool-addressbook, pos-tool-contact-detail

Definition: A Tool is a self-contained web component that manages a particular type of data or task.

Purpose: Tools provide functionality such as displaying, editing, or managing data. They can be embedded in multiple apps, providing consistent behavior across different contexts.

Example: The pos-tool-addressbook can be used both in the Contacts App for managing a contact list and within the PodOS Browser to display address book data from a specific Pod.

  1. Elements

Elements are small, reusable UI components that form the building blocks for more complex interfaces. They are used in both Tools and Apps to construct the visual interface.

Example: pos-contact-card, pos-address-form, pos-person-preview

Purpose: Elements are atomic UI components that provide specific functionality within a Tool or App, such as rendering a contact or showing a form.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant