Looks like Aurelia is headed forward to the next level in the not too distant future. Webpack and Tooling will no longer be dependencies so much documentation will no longer be needed. Efforts to show how to do things (simple and advanced) could be diverted to comprehensive example sets and new adopters will find things easy to use from installation onwards. Perhaps a good place to place the official examples would be the Official site at a top level navigation item (ie same level as Guides, APIs Discourse, etc)?
Just wanted to update this thread with a pointer to our 2018 Q3 report: https://aurelia.io/blog/2018/11/04/aurelia-2018-q3-report We announced Aurelia Script and our Code Sandbox work, which I think are important steps to help address some of the issues in this thread. We’ll be taking additional steps through updates to the docs, getting started guides and home page in the coming months. Everything that we’re learning and doing for vCurrent, we’re carrying over to vNext so that we have everything in a better state from day one with the next major release. Thanks again to everyone for their feedback and continued support! We take it seriously and we love working together with you to continue to improve Aurelia.
VNext sounds good. I’m not sure about the new bundling thing or if I understand it correctly. The reason has been that it’s been a bit of a sore point for myself getting projects off the ground (as in small enough bundles, bundling just working in general and writing new TS/JS).
Here’s something from a perspective of a mostly backend programmer in .NET that occasionally does something on the front-end.
A big problem for me and some others I know has been setting up an “industrial strength project”. Related to already written here, I very much like to have take Visual Studio and have a web project “that just works”. The “just works” in a problem since then I go to see how to:
- The new Babel 7 + TypeScript + Aurelia + WebPack (https://blogs.msdn.microsoft.com/typescript/2018/08/27/typescript-and-babel-7/ got it working finally).
- Split bundles by feature (fast basic things, then extra pieces per portion like based on route).
- Split the aforementioned bundles so that they’re for “the fairly newest” and then the older ones (i.e. not giving a lot of code to newer browsers).
- Switch writing direction (some CSS plugin).
- Usability. What’s the story here is one uses Aurelia? Is Aurelia better or worse than others? This is coming increasingly an issue especially in public projects. It hasn’t got yet as much attention as GDPR, but https://ec.europa.eu/digital-single-market/en/web-accessibility is coming fast (no headline grabbing penalties?).
- Set perhaps bundle alerts either in WebPack or then just read the bundles in the XUnit test project and fail tests if exceeding some size.
- Set up some sort of a bundle visualization.
Then I want to integrate Aurelia via MSBuild so it does debug, release and packing (also “DebugRelease” and “ReleaseDebug” see also bundle visualization and how much optimization there is and other measures). It took a lot of time to piece these things together and then I noticed very helpful blog posts
The aforementioned blog posts may help others too and maybe can facilitate discussion here, so I’ll give here. Related to them, I might want to set up XUnit project (handling DB things and others) that can start a headless Firefox/Chrome (Edge coming) to have nice tests rolling constantly while working (something to keep in mind with the testing story).
Echoing what @dwaynecharrington wrote, an example with OpenID sign-in was a real sore point I know has tipped the scales towards other frameworks. Currently there is another thing on the .NET world and it’s Blazor (WASM) in .NET Core 3.0 rather soon. Currently, server side rendering via WebSocket (SignalR), but there’s also work on client side WASM which will be interesting. The goal is to have a full stack with .NET using Razor. I see Aurelia is a suited option, but I think many are looking into WASM and are thinking using Aurelia together with Razor as already now. Related examples I know people have been wondering are Aurelia in PWAs and how to do some of the rendering on server side using Razor (and still have things like routing work).
I was very happy to see those announcements yesterday. Great work everyone!
That only concerns public sector, so of course it’s not going to get too much attention as it only affects very few.
Will there be an upgrade path for those of us who (foolishly, in retrospect) opted to use JSPM and Gulp?
@joelowrance start a new project with cli, install packages, and copy files from the old project… done
I suffered from having chosen jspm past year.
I did what Maxim says, start a new project and copy source files.
The issue is that all references to modules must be done with PLATFORM.moduleName. Otherwise, webpack doesn’t “see” them.
I would expect GDPR to affect far more than the public sector, indeed all companies doing business in Europe both pre/post - Brexit and far beyond. $20 Trillion is 20% of world GDP and presumably business would be interested in participating in some of this market
That kind of thing is great for gaining traction.
Certainly a game changer for all adopters.
Btw with regards to component vendors and Aurelia
We were talking about the web accessibility directive, not GDPR.
Yeah let me just briefly describe the overall problems, because as an experienced engineer I recognize the elegance of Aurelia (The Einstein philosophy of elegance and simplicity => correct) hence why I adopted it… (no it wasn’t because I had never heard of vue or react at the time! No it wasn’t cuz I have an irrational irritation to strong typing and hated angular2 switch to typescript). I’ll try to be constructive, please don’t take it the wrong way.
- Starting with the TINY “get started” button on the main Aurelia page. haha. Make it bigger!
- Get started takes you to TODO tutorial. Too much setup. Why is it showing me index.html? I don’t care about that. As a beginner I only care about “app.html” and “app.js”. Instead the tutorial should start with “npm install” and “npm install au-cli” or something. Then “au new TodoProj --quicksetupskipallthedamnoptions”.
- Why not just put a pasteable CSS (CDN-hosted link to CSS via link tag) to make the todo app look slick?
- MORE SCREENSHOTS. There are very few screenshots of each code result. Many engineers learn visually rather than reading (great idea on CODEPEN links Mr. Eisenberg!!!). Some people secretly hate reading it seems.
- What the? visual studio is being discussed in the todo tutorial? Most ES engineers (that I know in my industry) use Visual Code or Sublime or notepad++.
- I was comparing to the Vue.js intro tutorial… and I got so bored out of my mind because it’s so lengthy. But they had it right when they started off super simple, super easy install, and then showed a custom component. No custom component / element stuff exists in Aurelia’s tutorial. However, it went on way too long. I don’t have the patience for anything except Chess!
- Oh, Aurelia todo tutorial is telling me about main.js now, I really don’t think I care as a beginner. Au cli should do the bootstrapping for me already. Oh and by the way, “au generate” is broken at this time. Think about tutorials like “twitter” if you can fit your tutorial in 150 characters, even better.
- Put some more tutorials on getting started, basic custom elements. Basic UI elements utilized. There was a section in AureliaCasts about ToastService event-aggregator, that was a great simple tutorial in the middle of a video! How do I create a component quickly and connect a folder of new custom elements?
- Perhaps have a tutorial for “blog post” (but without all the “archives” and other nonsense things of traditional blogs), just show me the router & url-slugs!
- Insert an advanced UI framework tutorial (AureliaCasts was a great tutorial for me, loved it, but I no longer enjoy bootstrap, I am more into Material design now). Maybe you can write a tutorial utilizing Aurelia Material Design (aurelia-materialize-bridge?) showcasing some advanced UI capabilities that engineers today are interested in.
- More advanced tutorials: how do I design a plugin? How should I organize my static assets?
- Demos, codepens, demo links…Have links to cool demo sample websites. The coolest thing I’d want to see first would be to see all big websites using aurelia or some big sample apps using aurelia that look sleek and modern. I saw there was a “aurelia-ux-showcase” and there was no demo link to it, I tried compile, didn’t work, gave up.
@ArchEnemy Thanks for the feedback. It aligns well with a lot of what we’re hearing from others and what we’ve been thinking too. We’ve been doing some core work on our docs infrastructure lately. In the next few days we’ll be deploying with some minor updates but the interesting new thing is that we now have an easy way to put CodeSandbox demos anywhere in our docs…so we’ll be doing more of that. Next up after that is released, I’m going to re-work the Todo tutorial. No downloads, no installs, no configuration…just getting straight to the learning. Our plan is to put CodeSandbox side-by-side in the browser with the tutorial so you can actually learn in the browser. Since we skip all the setup stuff, we can probably replace that with some more interesting additions, such as showing how to create a custom element, like you suggest. I think that’s a great idea. Summary is, we’re working to incrementally address these issues. We’re doing as much as we can for today’s Aurelia and also working to carry all of this forward for our vNext Aurelia as well, so we start out of the gate with that in a more solid position.
From my own experience, initial impressions were very important to me. I needed to be able to get the CLI, ‘new up’ a project, build and run it without issue. This was not the case. I look around many dotnet CMS projects every so often and, after a short while, leave the projects that require too much time to get up and running or cause me to troubleshoot.
First impressions are vital. One needs to be able to:
- Clone repo or CLI a new project
- Install the dependencies
- Run it
This should happen with zero errors and show nothing but good news in the web console of developer tools. This was not my experience. I made some forum posts earlier this year including:
My thoughts are in there.
Aurelia is my framework of choice and it is a bit of a shame it is not much ‘bigger’. It really deserves to be. Show Aurelia’s power as succinctly as possible to first time visitors (or even those revisiting) and do so without that user needing to troubleshoot. It must just work.