Skip to content

Latest commit

 

History

History
124 lines (93 loc) · 7.65 KB

ROADMAP.md

File metadata and controls

124 lines (93 loc) · 7.65 KB

Roadmap

The roadmap is a living document, and it is likely that priorities will change, but the list below should give some indication of our plans for the next major release, and for the future.

⚠️ New features based on v0.19.x have low priority and will most likely not be reviewed nor merged. We want to focus on bug fixes.

Version 1 (published on NPM under the next tag)

Version 1 release is going to be huge ✨. We host a temporary documentation site for the pre-releases.

Material-UI was started 3 years ago. The ecosystem has evolved a lot since then, we have also learned a lot. @nathanmarks started an ambitious task, rebuilding Material-UI from the ground-up taking advantage of this knowledge to address long-standing issues. Expect various breaking changes.

The core team is now helping him in the v1-beta branch. If you are interested in following our progress or if you want to help us reach that goal faster, you can have a look at the following milestones:

Q&A with the v1 version

The v1-beta branch has become more mature, so we think that it's a good time to communicate more on this effort. We have a lot of people opening PRs and getting them closed, this is not a good thing. This Q&A tries to answer some of your questions.

Summarizing, what are our main problems with CSS?

The CSS (cascading style sheets) specification emerged in 1994. At that time, a bunch of others specifications were competing. It was the cascading concept that made CSS succeed over its competitors, by allowing users to provide their own style-sheet, that will be later combined with browsers and authors style-sheets. That feature was removed 2 years ago from the most popular browser. My point is, our needs have evolved quite a bit since then.

Back in the beginning of Material-UI, we had many issues with the first LESS approach. Aside from the problem with CSS at scale raised by @vjeux, we had the following ones:

  • We had a dependency on the LESS build chain with no way to abstract it away. Users needed to change their theme variables. @gpbl was maintaining a SASS version. (Today, we could be using cssnext).
  • The theme was computed at build time but a Material component must be able to render quite differently depending on his context that can only be known at runtime. (Tomorrow, CSS variables will help a lot)
  • We were shipping a big monolithic CSS file. That's not great for performance (for example it goes against the PRPL pattern suggested by the Polymer team). That was also an issue for users wanting to use a single component without paying for all the CSS upfront.
  • We used multi-level selectors, making the override of styles challenging.

We later came up with an inline-style approach solving the majority of our issues. But:

  • We had lost around 25% of the performance 🐢. Computing the inline-style at each render with no caching isn't really efficient.
  • Some more advanced CSS feature weren't available, e.g. keyframes, pseudo-elements, pseudo-classes 💅.
  • Media queries weren't available on the server. At least not yet.
  • Debugging was really challenging. Browser dev tools aren't tuned for inline-styles.
  • React v15 has changed the method of injecting styles into the DOM meaning, for example, that prefixing all browsers for display:flex is no longer possible 💥.

Does JSS solve them?

Yes, it does. You can have a look at this presentation for more details.

What does it mean to migrate a component? Should we discuss each one of them first?

Migrating a component to the v1-beta branch isn't just a style migration. We think that it's our best opportunity to clear the API and improve the implementation of the components. @nathanmarks ended up fixing a lot of long standing issues in the process.

Yes, it would much better to discuss an action plan for each of them that would save us considerable time compared to blindly following a wrong path. We should answer the following questions:

  • What will the API look like?
  • What trade-offs are we going to make?
  • What features will be implemented?

That conversation could start on one of the following issues.

How do I know if a component still needs to be migrated v1-beta?

We have some open issues to coordinate the work toward the v1.0.0 release.

How do I start migrating components to the v1-beta branch?

Once we agree on the migration plan you're going to have to get your hands dirty. That's really up to you. At least, you going to have to:

  • clone the v1-beta branch
  • install the npm dependencies
  • play with the documentation site
  • write some documentation
  • write some tests (unit, integration, visual)

When do we intend to release v1?

We don't have an ETA for the release of the v1, however, we are going to try to follow this plan:

  1. We completely address the styling issue before moving from alpha to beta.
  2. We publish our first beta releases.
  3. We fix the last API inconsistencies (as we can make breaking changes without having to worry much).
  4. We merge the beta branch into master
  5. We publish our first pre-releases, if all goes well, we move to the next step.
  6. We publish v1 🎉

At that point, some features and components from the v0.x will be missing in the v1. So, what about them?

  • First, both versions can be used at the same time, people can progressively migrate, one component at the time.
  • Then, with the help of the community and over time, we will support more and more components.
  • We would rather support few use-cases very well and allow people to build on top of it than many poorly.

Have we ever considered using the best libraries for each piece of functionality and provide only a wrapper for the UI?

We have, it really depends on the problem we are trying to solve. For UI related things, providing a wrapper for the functionality is often the wrong approach. We think that it should be done the other way around, i.e. providing a low-level API that can be combined with third-party libraries, e.g.:

On the other hand, using a smart date library for the DatePicker / TimePicker would probably be much better as date management is tricky and not a core business.

Future

  • Add missing components, and missing features from current ones
  • [#7721] Preact support
  • [#593] Support React Native