The end of @material-ui/pickers 🙈, long live @mui/x-date-pickers

[dmtrKovalenko]

And that's not the time to cry! ✌️❤️ After a long year of work on v4, pickers are finally taking an official place at MUI. It's meant to move under MUI X. So mui/material-ui-pickers is no longer supported.

We have closed the docs and moved all the work which will include the new era of date & time picking! In MUI X, this project will live as a generic date picker library, with a deep Material UI integration, among others.

Contributors

Thank you for being here for the 3 years of this project's existence and the giant thanks to our awesome contributors! And also a special shout-out to the collaborators and maintainers of pickers:

• @dmtrKovalenko - author and main maintainer
• @TrySound - supercharged our build process
• @cherniavskii - helped a lot on the project start
• @alitaheri - improved our localization and was an author of different calendar systems support!
• @sakulstra - made a lot of contributions
• @rosskevin - helped to rewrite the project in typescript
• @LastDreamer - made several great features

They will be thankful if you will follow their great work on Twitter 🦊.

What's next?

Thank you, be safe, and will see you at https://mui.com/x/react-date-pickers/getting-started/. You can follow this migration guide: https://mui.com/material-ui/guides/pickers-migration/ to move from @material-ui/pickers v3.

Version history

Based on the version of Material UI, find the following corresponding date picker:

Material UI	git repository	Docs	npm package	Last release
^0.15.0	https://github.com/mui/material-ui/tree/v0.x	https://v0.mui.com/#/components/date-picker	material-ui	v0.20.0
^3.0.0	https://github.com/mui/material-ui-pickers/tree/v2.2.4	https://material-ui-pickers-v2.dmtr-kovalenko.vercel.app/	material-ui-pickers	v2.2.4
^4.0.0	https://github.com/mui/material-ui-pickers/tree/v3-x		@material-ui/pickers	v3.3.10
^5.0.0-alpha.5	https://github.com/mui/material-ui-pickers/tree/next	https://material-ui-pickers-git-next-mui-org.vercel.app/	@material-ui/pickers	v4.0.0-alpha.12
^5.0.0	https://github.com/mui/material-ui/tree/master	https://v5-0-6.mui.com/components/pickers/	@mui/lab	v5.0.0-alpha.1
^5.4.1	https://github.com/mui/mui-x	https://v5.mui.com/x/react-date-pickers/getting-started/	@mui/x-date-pickers	v5.0.20
^5.4.1	https://github.com/mui/mui-x	https://v6.mui.com/x/react-date-pickers/	@mui/x-date-pickers	^6.0.0 (LTS)
^5.15.14	https://github.com/mui/mui-x	https://mui.com/x/react-date-pickers/	@mui/x-date-pickers	^7.0.0 (active)

[simplecommerce]

@dmtrKovalenko Hi, great work on this library, I had a question, will the v3 and the docs still be available on this repo even if Material-UI v5 is stable and out?

I just want to know in order to prepare if I have to force and make a change in our current project.

Thanks for the great work again on this library!

[dmtrKovalenko]

@simplecommerce It will be available under the same domain name. Just I am going to add a persistent banner about the project migration

[neolivz]

What happened to MuiPickersUtilsProvider?

[oliviertassinari]

What happened to MuiPickersUtilsProvider?

@neolivz https://mui.com/material-ui/guides/pickers-migration/#muipickersutilsprovider

[j209]

What about suporting jalaali or hijri calandar system in material-ui v5 ?

[oliviertassinari]

@j209 We are using date-io, so it should still be supported. Would you like to add a demo for it?

[rajzik]

@dmtrKovalenko Maybe archive this repository as it is no longer active?

[dmtrKovalenko]

@rajzik once all the issues will be moved and the core documentation demo for pickers will be fixed  – I will definitely archive this repo :)

[j209]

@j209 We are using date-io, so it should still be supported. Would you like to add a demo for it?

It would be great if there is a demo for hijri and jalali calendar support in material ui v5+.
material-ui-next date picker demo

[MartinDevillers]

Great job on getting adopted in MUI V5 and on building this in general. As a frontend developer I've been working/dealing/struggling with date pickers for almost two decades now, so I know how much effort it takes to create a usable date picker. Moreover, even in these modern days I see major players like Microsoft Windows 10 missing the boat completely. So kudos on getting this one right.

Looking forward to migrating to V5. Cheers 👏

[boonya]

Hello. Is there any information why does https://material-ui-pickers.dev/ not work?

$ curl -vk https://material-ui-pickers.dev/
*   Trying ...
* Connected to material-ui-pickers.dev (...) port 443 (#0)
* ALPN: offers h2
* ALPN: offers http/1.1
* (304) (OUT), TLS handshake, Client hello (1):
* LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to material-ui-pickers.dev:443
* Closing connection 0
curl: (35) LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to material-ui-pickers.dev:443

[dmtrKovalenko]

I think I stopped paying for the domain. Do somebody still using it 😱 ?

[dmtrKovalenko]

@oliviertassinari Can you please check if you still have this project's documentation deployment in material-ui vercel account? If yes, could you please share its link here?

[simplecommerce]

we still use it also but only until we can upgrade

[boonya]

I think I stopped paying for the domain. Do somebody still using it 😱 ?

We do. It's not that easy to quickly migrate big project with its bureaucracy and so on.
I would suggest to use Github Pages as a hosting for such documentation. If you want I can help. I have an experiance.

[MartinDevillers]

I think I stopped paying for the domain. Do somebody still using it 😱 ?

If you want I can take it over from you and keep the site up and running for a while. I've moved my projects over to MUI-X V5 but I understand there's still people on older versions who want/need support.

[dmtrKovalenko]

There should be a dedicated vercel deployment with its own url. But the problem that I don’t have access to mui’s vercel anymore. Need to wait for Olivier’ response.

[oliviertassinari]

I have tried to redeploy but it's broken. We are under the free plan of Vercel which limits server functions, no team members, Node.12 is no longer supported, and there are more issues. I think that the simplest if for developers to clone the repository locally and to run the dev server.

[dmtrKovalenko]

Hmm, but the previous deployment of the project should be up? Or it is down? It was running all these years somehow...

[oliviertassinari]

v4 is still running, I have updated the table, but v3 crashes https://material-ui-pickers-git-v3-x-mui-org.vercel.app/, redeployment crashes as well. I'm not sure how long it will keep running. It might be the downside of having the pages server side rendered.

[dmtrKovalenko]

Thank you! I think that's fine.

[Bloodyaugust]

Checking in as another someone who would really like access to the docs (for @material-ui/pickers@3.3.10).

[darkemlord]

Please upload the documentation again :'(

[markcorrea]

Congrats! But did you really have to delete the old documentation? What about the users that still have to upgrade huge systems and can't migrate in just one day?

[dmtrKovalenko]

It is not deleted, it is in sources. You should be able to run it locally. But the infrastructure behind it is so old that it is not possible to easily redeploy it.

[pedroassis]

@darkemlord @dmtrKovalenko @markcorrea

I have published this under github pages, you can use mine if they don't copy it to theirs.

https://pedroassis.github.io/material-ui-pickers/

I can send a PR if you want.

If anyone responsible for this repo (which has 500k downloads weekly in the last year even after the docs were haphazardly deleted) wants to copy this and release it:

add this to your branch:
https://github.com/pedroassis/material-ui-pickers/blob/next/docs/package.json#L9
https://github.com/pedroassis/material-ui-pickers/blob/next/docs/next.config.js#L28

Run

cd docs
yarn build
yarn export

export logs a bunch of errors but it seems to have worked.

Now the index file needs to be in the root, I was too lazy and just copied the whole out folder to the root.
You might be able to fix the basePath|assetPrefix to point to /docs/out, I wasn't in the mood to try it.

[dmtrKovalenko]

@pedroassis thank you so much for doing this, probably that should've been me (because it was my project originally) so I'm sorry and thank you.

We should probably update the repo itself, but I don't think I have the permissions in Mui org anymore. We should ask @oliviertassinari or somebody else

[oliviertassinari]

I have published this under github pages, you can use mine if they don't copy it to theirs. https://pedroassis.github.io/material-ui-pickers/

@pedroassis We already have the docs for v4.0.0-alpha.12: https://material-ui-pickers-git-next-mui-org.vercel.app/.

Would you happen to have the one for v3.3.10? It's the one we are missing, thanks.

[pedroassis]

@oliviertassinari hnm, I didn't see that lol, should be added to the readme/npm package.

I'll take a look at 3.3.10 tomorrow and let you know.

[pedroassis]

@oliviertassinari @dmtrKovalenko

I also haphazardly worked on the docs, I needed v3 too.

I changed my repo to v3.3.11 and it look alright.

GH Pages is funky, I suppose you guys will use something else to serve it.

A good old static http server will do, with some rewriting rules to make the links work properly.

The files you are looking for will be on docs/out, however the paths are setup for my GH Pages.

Let me know if I can help set that up.