denkstrap 3.0 is a frontend boilerplate. It provides a very basic setup of an project structure to help you get started, without worrying too much about build tasks and JS architecture.
WARNING: Version 3 is NOTcompatible with modules from previous versions.
- Node.js v8 LTS with npm
- Recommended nvm (Node Version Manager)
- Mac/Linux nvm
- Windows nvm-windows
We recommend the installation of nvm or nvm-windows. With nvm you can change your Node.js version easily without having to reinstall Node.js completely. Especially if you have to run several projects with different Node versions, nvm can be a real blessing.
Please check first if you have the current Node.js version 8 LTS installed. You can check which version of Node is installed by typing node --version in the console of your choice. If the version shown is >= 8.9 your good to go.
See our Troubleshooting Guide for more help with Node.js and the Node Version Manager (nvm)
To start a new project based on the denkstrap, proceed as follows:
- check out the GitHub repository and delete the
.gitfolder or download the denkstrap as a zip. - navigate to your project with the console and run
npm installin the root directory to install all dependencies. - Start development with
gruntorgrunt default.
If errors occur during installation or development, please check our Troubleshooting Guide to see if there is already a solution. If your problem is not listed, just set a new Issue and we will look together how we can fix it.
When someone changed or updates package.json or package-lock.json, you should run the command npm update.
When you have all requirements installed, run the following grunt tasks to build the frontend:
grunt development or grunt dev for a development build with uncompressed sources.
grunt production or grunt prod for a production build with compressed sources.
The generated output will be located at ./dist
Additionally you can run the grunt lint task to ensure all sources are bug-free and follow the coding guidelines.