The Accuraty Solutions starter kit for DNN projects.
- DNN site already deployed
- Node >= v12.18.0
- Initial setup (you are starting from scratch)
- Cloning locally (first time adding this project to your machine)
This assumes the project has not been started. If it already exists on GitHub and you need to get set up on your own machine, skip to Cloning locally.
Create a new project folder on your local machine, cd into that directory, and run the following commands in your terminal:
git clone -b master --single-branch https://github.com/chrismlusk/accuraty-templates.git .
rm -rf .git
git init
That will clone the master branch of this repo into your current directory, delete the Git history, and start fresh.
If you are using Visual Studio Code, go to the .vscode/ directory. Duplicate sftp.json.example, save it as sftp.json, and update the first three lines with your credentials.
Although sftp.json is configured to automatically push files to the server, you need to manually upload certain directories when you first set up a project. Right-click on the app/ folder and choose "Upload Folder" from the menu.
From your terminal, run npm install.
After the install is finished, npm run build will automatically run. This compiles assets (styles, scripts, etc.), but Gulp won't stay in "watch" mode.
Go to the Accuraty GitHub account and add a new repository.
Name the repository using the client code and project year, make the repo private, and then do not initialize with a README. Skip that step since you will import the existing local repository you just created.
Back in your terminal, run the following commands:
git add -A
git commit -m "Initial commit"
Then, follow the "…or push an existing repository from the command line" instructions in the new GitHub repo, which is to run these commands (be sure to update the code below with your repo URL):
git remote add origin _GITHUB_URL_HERE_
git push -u origin master
Be kind to others. Make these changes:
- Update the title and description to match the project.
- Delete everything but the "Cloning locally" steps from "Getting started."
- Replace _GITHUB_URL_HERE_ with the URL of the repo you created.
Navigate to the directory where you want to store the project, copy the GitHub URL, and then run the following commands in your terminal:
git clone _GITHUB_URL_HERE_
If you are using Visual Studio Code, navigate to the .vscode/ directory. Duplicate sftp.json.example, configure it with your credentials, and save it as sftp.json to continue.
Next, run npm install.
After the install is finished, npm run build will automatically run. This compiles assets (styles, scripts, etc.), but Gulp won't stay in "watch" mode.
Run npm start.
This will kick off the Gulp tasks to optimize and compile assets (images, styles, scripts, etc.). It will also continue watching for changes to source files.
To exit "watch" mode, press Control-C in your terminal.
To start watching again, run npm start.
Because you cloned the repository using the GitHub URL, your local repo's origin is properly set. However, if you get an error message when you try to push your changes up to remote, it's because you do not have permission to write to the private repo.
Make sure (1) your GitHub credentials are correct, or (2) your GitHub username is added as a collaborator on this project.
Accuraty Solutions is a full-service website firm that provides a wide range of web services: design, development, applications, hosting, e-commerce, and more. We deliver creative, effective results and have extensive experience in building useful online presences for businesses, organizations, and communities.
Reference: Accuraty Solutions