As for now there are some things to consider when providing a lib for Web IDE and other IDEs.
Web IDE does place contributed libs in your project inside a folder named after the lib, while Particle Dev wants (at least used to, last time I used it ) it to be in your project root folder.
So I usually do this
#define PARTICLE_WEB_IDE // uncomment for Web IDE
//#define PARTICLE_DEV_IDE // uncomment for Particle DEV
// to avoid "No such file" errors
// whatever else
Some other things, like the folder structure and the mentiond JSON file and other things should be done as shown in UBER-LIBRARY, but are also checked when contributing your lib.
Just make sure that all your provided examples do actually build without error before publishing your private lib to the public - that makes corrections easier
I usually need at least three iterations to get it running propperly