We need aurelia-ux tutorials

Aurelia still suffers from a lack of a proper UI compared to its rivals. However, recent advances have been made in this regard.

Aurelia UX
Aurelia UX Components

unfortunately, we can not use some fantastic projects like Aurelia UI Framework because of Is mobile ready?

so, It seems we need two kinds of tutorials:

  1. How to use aurelia-ux (using current controls)
  2. How to develop and contribute aurelia-ux (create custom control for it)

for example my friend developed Aurelia Star Rate we need to know how to add it to aurelia-ux?

If anyone has great information about Aurelia-UX, please share the tutorials on how to use, develop, and contribute.

Thanks.

2 Likes

Documentation is high on our list of priorities for UX. I know there is not much there right now to help people jump in and get started, but this is set to change now that a couple rather large undertakings have been completed. Namely, we have changed how the style engine works and moved to a Monorepo design that should help make it where you can either install all component packages or just install a few components.

Aurelia UX is the only repo being maintained. After we created the Aurelia UX Components repo, we made the decision to give Lerna a try, which made the separate repository for the components no longer necessary.

2 Likes

I suggest that the Aurelia team present a roadmap in all areas that it is working on.
For example, Server-side rendering (SSR) and even Aurelia-UX ,…

This helps the Aurelia community to better plan. For example, if I know that SSR will be released in the next 9 months, I will plan for this period. I’m sure this time is worth it because Aurelia will be the best in all areas

I hope we will soon see a roadmap for the Aurelia so that everyone can plan to use this fantastic project.

I sincerely thank all those involved in this project.

Aurelia has been the best client side project I’ve ever seen.

Long Live Aurelia.

6 Likes

Though not really an official, detailed roadmap, Rob did give an overview here in November 2016:


Exciting times!

1 Like

This was one year ago! I think the community needs some fresh feedback about the future roadmap in order to make better and informed decisions.

For example, ember just announced version 3 https://www.emberjs.com/blog/2017/10/03/the-road-to-ember-3-0.html

Those things helps to develop a stronger community, make new people jump in and invest in the framework learning / picking.

Aurelia is awesome, way better than many other alternatives but we need to make some noise!

1 Like

Why do you wait for aurelia-ux instead of choosing one of the existing ones like bootstrap, materialcss etc.?
Check out https://material-components-web.appspot.com those components will be easily integrated into your aurelia app (they were designed for use in modular SPA’s)

First, Aurelia-UX is the official UI framework of the Aurelia.

Second, the Aurelia-UX has unique features that you can see in the link below:
Aurelia-UX wiki

Third, we need to use good features of Aurelia, not just pure HTML and CSS
Templating: Custom Attributes
Templating: Custom Elements Basics

So if you want to plan for a long term project, it will be very good to use official and recommended solutions that are integrated for a variety of fields.

We agree with your three points. Especially because we’re evaluating a SPA framework for a long term project.

After the first evaluating round there stays Angular 2 and Aurelia. For me, Aurelia looks great and I really like the philosophy! There is just one uncertainty about the UX. We have seen, that there is an npm module ‘aurelia-ux’ (version 0.3.0) and a showcase application https://github.com/aurelia/app-ux-showcase. But there is also the npm module ‘@aurelia-ux/core’ (version 0.6.0) with the same documentation / showcase app, like in the module ‘aurelia-ux’. We googeld a while to find some statements about it, but unfortunately without success…

Is there a short and current documentation about Aurelia-UX? Is the showcase application up to date? Should we use aurelia-ux or @aurelia-ux/core and it’s dependents? We think @aurelia-ux/core…? Is there a short example or how-to for @aurelia-ux/core? Thanks for your help…

I hope Mr. @EisenbergEffect 's roadmap will also include Aurelia-UX.

@dan here is a blog post that was published mid November that should help clear up some of your questions. Aurelia UX Overhaul.

To answer more directly, aurelia-ux is a legacy package at this point. The current package that should be used is @aurelia-ux/core. If you need the official Aurelia UX components the easiest package to bring in after that would be @aurelia-ux/components.

Currently all of the components have been split up into their own packages. This lets users pickand chose what they wish to use. Not everyone wants everything at once, but for those that do there is the components package. You can find all of the Aurelia UX packages here. NPM Aurelia UX

The UX Showcase is currently behind. Documentation is very high on the priority list, and in the coming weeks we should be figuring out just how to best put up documentation for Aurelia-UX. At that time the Showcase will likely be updated as well.

Also for an example, this is the most up to date example using Aurelia UX. aurelia-store-todo

This contains a few different ways to style UX components and basic usage of a few.

@ZHollingshead

What matters to me is why you used Lerna?

Currently all of the components have been split up into their own packages. This lets users pickand chose what they wish to use. Not everyone wants everything at once, but for those that do there is the components package.

Why did not you use the plugin/feature in Aurelia? like our aurelia-toolbelt

Do we also have to use Lerna?

You will not need to use Lerna. Lerna is a tool for managing multiple packages and nothing more.

With the new structure, you can include all of the components or chose to include just a few of them. Lerna simply allows us to build all of the components and perform releases very easily and quickly and has already proven to be a timesaver for us.

To be clear, each individual component is still a plugin, so if you want to install Aurelia UX and the components you would simply include the following:

aurelia.use
    .plugin(PLATFORM.moduleName('@aurelia-ux/core'))
    .plugin(PLATFORM.moduleName('@aurelia-ux/components'));
1 Like

@ZHollingshead Thanks for your quick answer and the links! We will have a look at them. Especially |aurelia-store-todo| sounds good. I‘m sure that this will provide us with valuable informations!

FWIW I created this post after having a bit of a play with aurelia-ux in the last few days: https://winterlimelight.com/2018/01/05/using-aurelia-ux-v0-6/

3 Likes

Hello @dan; my team is in a similar situation and we’re looking at Aurelia and Vue (I prefer Aurelia but we are a team). Can you share with the community why you bypassed Vue in favor of Aurelia? I am sure many of us are facing the same challenge: convince our team that Aurelia is “better” than Vue despite all the hype/publicity Vue is currently enjoying. Thank you very much for sharing and for your time.

Hi @frankmonroe; We didn‘t have a close look at Vue, just a very short one. We had a closer look at Angular. So unfortunately, I can not really tell you a lot about Vue.

Clean code, convention over configuration, the framework in general (it stays out of your way) and the philosophy - just to name a few – let us choose Aurelia

One thing – which almost gave Angular the preference - was the UX. It looked, that Angular already has a lot to offer to create easy and nice looking GUIs. Things like good documentation, fast development, a lot of experience, Material Design… . Now with Aurelia UX everything looks a bit different. If documentation is coming and easy to understand examples, then for me Aurelia is the one.

For us (we are a bunch of Java developers) good documentation and examples are important. Of course we know the “common way” to develop web applications, but we are not JavaScript and SPAs experts and still learning.… But now there are three books about Aurelia on the marked already and this was also argument to go with Aurelia. Like the growing community. Hope my answer helped a bit…

Thank you kindly for sharing.

FYI, Aurelia UX 0.7.0 was just released and the showcase was updated to reflect the new components.

There is also a live demo here until we can get the documentation hosted on the main Aurelia site. https://aux-demo.firebaseapp.com/getting-started

Based on the provided documentation I pose this question to you. What is missing from the documentation that would make Aurelia UX easier to use and get started with?

5 Likes

How about implementing theme selection in the showcase app? I’m also looking forward to ux-select. Once that arrives, I’m looking to try aurelia-ux in an internal proof-of-concept app at my workplace.