FAQ
AgnosticUI is:
a set of UI primitives that start their lives in clean HTML and CSS
So for questions like “why don't you have component X?” The general answer is that maintaining the level of complexity required by said component in core would greatly increase scope and size of the project and increase the bug count thus making the project infeasible for the maintainers.
For folks in the community that are really motivated to create such components, we can certainly house those in the addons repo with the disclaimer that the component is community supported.
Why no Tooltip?
Yes, one would think a tooltip is a simple component to include but there are some considerations:
Viewport calculations must be done such that when the user has scrolled that point to the top of the screen, a tooltip initially set to show on top will now show on the bottom. popper.js calls this feature flipping
Overflow prevention as also discuss on the popper.js site
What's the recommendation then?
Use the aforementioned popper.js or one of its ports:
Core contributor incentives
The AgnosticUI project is certainly hoping to be a very contribution-friendly community. We are thinking of ways to feature contributors more prominently at some point—although the GitHub Insights Contributions listing does seems to provide this to a certain degree. Suggestions are welcome.
Where's darkmode?
It is planned for v2
I want to add an entire new framework (like Preact, Lit, Solid, etc.)
Awesome! AgnosticUI was partially inspired by the TodoMVC project which eventually had a crazy amount of framework implementations! Likely, popularity of said framework, how much community contribution is being offered, and feasibility will all be considered.
In terms of broadly determining popularity in the frontend ecosystem the following are worth a look:
- astro.new (the Frameworks section) and npmtrends makes it convenient to list some frameworks side-by-side
If you'd like to contribute to adding a framework, please create a GitHub new issue and pitch the idea.
The Angular package seems less supported
This is partially true and we are looking for core Angular contributor(s) and/or an Angular package maintainer.
However, we've got the initial component set pretty far and there are already community members contributing 🙌. But yes, most maintainance activity will be done by the community at this point.
Where's the icon system?
AgnosticUI does not provide an icon system per se. We do have an .icon
set of classes to wrap SVG icons and each of the framework implementations offer this componentized. But, icons sets themselves are not provided.