@marklogic-community/grove-vue-template

    1.0.0 • Public • Published

    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 init
    • git 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:

    https://git-scm.com/book/en/v2/Git-Tools-Submodules

    Install

    npm i @marklogic-community/grove-vue-template

    DownloadsWeekly Downloads

    7

    Version

    1.0.0

    License

    Apache-2.0

    Unpacked Size

    11.1 MB

    Total Files

    182

    Last publish

    Collaborators

    • marklogic-comm
    • ralmodiel
    • paxtonhare
    • rjrudin
    • grtjn
    • dalaidunc