This project currently uses Node version 17.9.1 as the preferred environment
The easiest way to run a development environment for this site is to use Docker.
After installing Docker on your machine, run the following command to spin up a container with a functional Eleventy environment:
docker run --rm -v /path-to/this-repo/on-your/disk:/app --name eleventy -p 8080:8080 femtopixel/eleventy --serve
Note: Replace /path-to/this-repo/on-your/disk in the above command with the local path to your clone of the tampadevs repository on disk.
We suggest using NVM, which manages the node-instance that you are using to run this project
You can install nvm using the instructions at NVM's official repository.
Now set the node version in the terminal for the Tampa Devs project:
nvm install 17.9.1
nvm use 17.9.1
If you use a windows environment follow the commands here instead with NVM https://github.com/coreybutler/nvm-windows
You'll want to install the CLI (command line interface) for eleventy. It's used to run the project
npm install -g @11ty/eleventy
Now run these commands while on the project
npm install
npm run dev
Theoretically everything should work fine, and you can navigate to localhost:8080 and make changes / see them instantly on the site
Here are some common issues we've run into regarding installation problems with this repo.
I'm getting a node-gyp error
It's probably a sharp module issue, this is used for image minimization. It runs best in a linux environment since it has a lot of dependencies associated with it. Try modifying the node version with nvm to see if you can fix it. There is also the potential to run this project in a docker environment, but have not been able to set it up (you need docker installed)
it says I need sass
Run
npm install -g sass
This project is tested with BrowserStack.