Ember Octane Workshop: Shlack
This is the project used for the Mike North's Ember Octane course, where we build a chat app together step-by-step
Prerequisites
You will need the following things properly installed on your computer.
Getting Set Up
There are a few things you need to ensure you have installed, in order to be ready for this course.
Node.js
You’ll need a relatively recent version (v10.0 or newer ideally) of Node.js installed. On OS X, a great way of doing this without disturbing your existing dev environment is to install NVM. Installation instructions are here.
You’ll know everything is set up properly when you can run
nvm --version # might look like "0.34.0"
node --version # might look like "v10.15.3"
Ember-CLI
Ember-CLI is the official Ember.js build tool. It handles things like:
- Running a development web server
- Running tests
- Code generation
- Compiling static assets
We can install ember-cli globally by running
npm install -g ember-cli
Now you should be able to run
ember --version
and see something like
ember-cli: 3.10.0
node: 11.6.0
os: darwin x64
Visual Studio Code
Particularly if you’ve never tried it before, you should install Microsoft Visual Studio Code. Some fantastic extensions that I use regularly include
Clone the Project
git clone git@github.com:mike-north/ember-octane-workshop.git shlack
Install dependencies
cd shlack
yarn install
Start the development server
ember serve
- Visit your app at http://localhost:4200
- Visit your tests at http://localhost:4200/tests
- Your app runs on localhost
:4200
by default. You can customize this via--port <port-number>
Code Generators
Make use of the many built-in Ember-CLI generators to get files that follow the latest practices (with matching tests_. To see available generators, run ember help generate
Running Tests
ember test
ember test --server
Linting
yarn lint:hbs
yarn lint:js
yarn lint:js --fix
Building
ember build
(development)ember build --environment production
(production)
Further Reading / Useful Links
- ember.js
- Development Browser Extensions
How this starting point was created
We could create a new Ember app by running the following command (you don't need to run this):
ember new <app-name>
This would create a project based on the default Ember.js app blueprint. If we want to create an Ember Octane app, we can use the official Ember Octane blueprint instead by running:
ember new -b @ember/octane-app-blueprint <app-name>
Beyond this, all I've done is...
Installed a few packages like
ember install ember-cli-tailwind ember-on-modifier ember-cli-pretender
Added the files in the server
folder, and the db.json
to provide a development JSON API, and created the notes
folder and markdown files inside it.
Legal
© 2019 LinkedIn and licensed under BSD-2-Clause license