aurelia-contrib / aurelia-getting-started

Basically a queue of topics and examples to cover
MIT License
20 stars 5 forks source link

Get started guide #2

Open Alexander-Taran opened 6 years ago

Alexander-Taran commented 6 years ago

Newcomers do not need choices. They need a straight path to quick success. Aurelias home page features "get started" article which requires dwnloading a zip file, exctracting and then chosing js vs ts. In CLI days it should be reviewed into

yarn global add aurelia-cli
au new

I'd even go further and remove all choices in the cli, unless you pass --i-know-what-im-doing flag (-:

mttmccb commented 6 years ago

Which choices would you make though? There isn't currently a default "just setup up a project", if it was aimed at beginners I would go with the choices that have the least friction (no .net core, probably no typescript, webpack, either no css pre-processor or postcss)

Alexander-Taran commented 6 years ago

@mttmccb I do agree.. and @lancelot316 started working in that direction.. https://github.com/aurelia-contrib/aurelia-getting-started/blob/master/guides/getting-started-esnext.md I'm keen on waiting for full stackblitz support.. so it could also be an interactive guide

lancelot316 commented 6 years ago

An interactive guide on stackblitz would be great, once support is available. I was trying to put together, with the tools that are currently available. Something easy to follow, that could get a newcomer up and running with as little friction as possible, to make their first experiences with Aurelia as enjoyable as possible. Personally I get frustrated when I try out a new framework and I can't get something simple up and running quickly.

obedm503 commented 6 years ago

agree with @lancelot316 stackblitz would be a lot better for just trying things out or even as bug repros. but hopefully @bigopon's awesome work on aurelia/framework#858 aurelia/framework#876 aurelia/templating-router#75 aurelia/templating#606 will make it possible

Alexander-Taran commented 6 years ago

here is a setup for es from @bigopon it works.. but it's totally manual bootstraping with some magic around it.. customized loader etc https://stackblitz.com/edit/aurelia-base?file=app.js

bigopon commented 6 years ago

It was Brazyli who made the loader, and Alex who put the base for Stackblitz, mine was topping 😄