grove-vue-template
Project template for Grove stack including:
- grove-ml-gradle (folder marklogic)
- grove-node (folder middle-tier)
- grove-vue-ui (folder ui)
Create a Project Based on this Vue Template
Follow the instructions in the Grove Getting Started Guide in order to create a new Grove project.
When asked which UI you prefer, select "Vue". Follow the in-console instructions to configure and run your application.
Developing your project
To install dependencies:
npm install
To create shared configuration between the three tiers (marklogic, middle-tier, and ui):
grove config
To run the tests:
npm test
To start a development server at localhost:3000:
npm start
NOT PREFERRED: Fetching and running this template manually
Manual fetching
Note that preferred way to install this template is using the grove-cli. Follow the instructions in the Grove Getting Starters Guide in order to create a new Grove project using grove-cli.
These are instructions for manually installing this template.
This template currently uses git submodules. You can clone it recursively using:
git clone --recurse-submodules https://github.com/marklogic-community/grove-vue-template.git {your-app-name}cd {your-app-name}
This gives you the master branch of the template, and its submodules. Use this to get the development branch instead:
git clone -b development --recurse-submodules https://github.com/marklogic-community/grove-vue-template.git {your-app-name}cd {your-app-name}
Consider running the following once if you suspect there are newer commits to the branches, that you'd like to pull in:
git submodule update --remote --rebase
It is recommended that you 'eject' from the Grove code repos after cloning this template, meaning you remove the git tracking from your local copy. You can do that with:
rm -rf .git .gitmodules */.git
You can then move the contents to a directory that is tracked by a different git project already, or initialize the newly created directory with a new local git repository:
git initgit add .git commit -m "initial commit"
In case you don't eject, you might want to occasionally check for updates, and merge them with your local setup. You can do so for all submodules using:
git submodule update --remote --rebase
It will warn for conflicts with local changes. Append the name of a submodule in case you'd like to run it for just one of them.
Getting the ui started manually
You should use the grove-cli to configure the application by running grove config. Further customization can be done manually in marklogic/gradle{-local}.properties and middle-tier/.env{.local|development|production}.
Run npm install in this directory, which will also run it within the ui and middle-tier directories.
Load sample data:
cd marklogic./gradlew mlDeploy loadSampleData
Run npm start in this directory, which will start the middle-tier and the ui. A browser window should open automatically (at localhost:8080)
Look inside the subfolder READMEs for more detailed instructions.
Further reading
For more background on git submodules, see: