Home

Awesome

Feathers-Vue

A Vue and FeathersJS fullstack app with authentication, email verification, and email support."

About

This project uses Feathers. An open source web framework for building modern real-time applications and Vue 2 with Server Side Rendering.

This project is not finished but if you are can be ready to use if you are content with what it offers.

Features

Getting Started

Getting up and running is as easy as 1, 2, 3, 4.

  1. Make sure you have NodeJS and npm installed. Feathers-Vue requires version 7.4 or higher, I recommend 7.6 since it natively supports async functions.

  2. Install your dependencies

    cd path/to/Feathers-Vue; npm install
    
  3. Run your build or watch

      npm run build
    
      npm run watch
    
  4. Start your app locally

    mongod
    
    npm run serve
    

In production run

```
  npm run production
  npm start
```

If you want emails to work using gmail add the following environment variables

export GMAIL=yourgmailaccount@gmail.com
export GMAIL_PASS=yourpassword or app-password

See How to set an app password

Testing

Simply run npm test and all your tests in the test/ directory to run server side unit test or run npm test-client to run client side tests.

Scaffolding

Feathers has a powerful command line interface. Here are a few things it can do:

$ npm install -g feathers-cli             # Install Feathers CLI

$ feathers generate service               # Generate a new Service
$ feathers generate hook                  # Generate a new Hook
$ feathers generate model                 # Generate a new Model
$ feathers help                           # Show all commands

Schemas go in shared/schemas

If you want the same schema to validate both client and server side put the schema in ./shared/schemas as it's own file with the file name being the name of the schema and resulting model.

You can use pattern and patternMessage directly in the schema and it will be converted to

validate: {
  validator: function(v) {
    return pattern.test(v)
  },
  message: patternMessage
}

for you.

Docker-compose

You may run

docker-compose up

to build a docker-virtual machine instance.

Help

For more information on all the things you can do with Feathers visit docs.feathersjs.com.

License

Copyright (c) 2016

Licensed under the MIT license.