/ayx-vue-starter

Starter template for building an Alteryx HTML/JavaScript tool using Vue.js and Vuetify

Primary LanguageVueMIT LicenseMIT

Alteryx Vue Starter Template

GitHub release Build Status Software License

An Alteryx Vue starter template for developing HTML/JavaScript tools with Vue.js and Vuetify

Requirements

Installation

Alteryx will typically install tools in one of the following locations...

C:\Users\{user}\AppData\Roaming\Alteryx\Tools
C:\Program Files\Alteryx\bin\HtmlPlugins
C:\ProgramData\Alteryx\Tools

Choose a location, clone and cd to project

# as of Designer 2018.1 this is the preferred global directory
cd C:\ProgramData\Alteryx\Tools

# clone 
git clone https://github.com/alteryx-vue/ayx-vue-starter

# or go ahead and start the re-tooling process
# git clone https://github.com/alteryx-vue/ayx-vue-starter your-project

# cd to project
cd ayx-vue-starter # or cd your-project

When re-tooling a new project, be sure to rename files and update metadata appropriately before building.

  • rename ayx-vue-starterConfig.xml as your-projectConfig.xml
  • rename component files (./src/components/AyxVueNav.vue as YourProjectNav.vue)
  • edit component script export names
  • edit template tags in App.vue, etc. (<ayx-vue-nav> as <your-project-nav>)
  • edit meta info in index.html and package.json
  • etc. and so on

Build Setup & Testing

Install dependencies

npm install

Dev Environment Testing

You can use npm run dev to serve the project with hot reload for testing in a browser.

limited functionality in browser - use for Vue component and/or state management debugging, etc.

Note: When using Chrome, be sure to make use of the Vue.js Devtools Extension

Build Production

Webpack and such..

# build & compile
npm run build

Webpack vue-loader is used for compiling .vue files.