Skip to content
My FSJS Project for Code Louisville May 2018 session.
JavaScript HTML CSS
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
public
src
.gitignore
README.md
package-lock.json
package.json

README.md

Animaldex

The purpose of this project is to demonstrate what I have learned during the Code Louisville Full-Stack JavaScript (FSJS) course. The project is an Animal directory where kids can track animals they have learned about and/or see in a CRUD application. This means that it will allow the user to create,Read, Update, and Delete information. The information will be persistent through a MongoDB hosted on mLab.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

  • Node.js (Preferably at least 10.5.0)
  • A Command line program like Terminal (Mac) or GitBash (Windows)
  • A browser (tested with Google Chrome, IE, Edge and FireFox)

Installing

  1. Clone the project files.
  2. Paste the .env file into the root folder of the project. If you just have the text for the file, you will need to open an ide like Atom, VS Code, or Notepad++ to create one in. Windows won't let you just create a file named .env.
  3. Install Node.js if not already installed. See 'Notes' section for install instruction links.
  4. Open a command line program. GitBash is recommended for Windows.
  5. Check that Node.js and NPM are installed by typing 'npm -v' and 'node -v' into your command line program. In both cases you should get some text displaying a version number.
  6. Using cd commands navigate to the root folder of the program. If you are using GitBash, you can open the root folder of the project, and right-click in the empty space to select 'GitBash Here'. This will open GitBash witht he location already set to the root folder.
  7. Type 'npm install' in your command line program so it will install the dependencies for the program.
  8. Type 'npm start' or 'node src/server.js' to start the program. See 'Notes' section if you expreience issues loading the app here.
  9. Navigate to http://localhost:4242 in a browser window. You should now be at the home page of the program. See 'Notes' section if you have issues loading this in a particular browser.

Built With

  • JavaScript - The programming language meant to be at the focus of this project.
  • Node.js - A JavaScript runtime that helps execute JavaScript code server side.
  • jQuery - A JavaScript library that helps with visual features and document transversal.
  • Express - A Node.js web application framework
  • Bootstrap 3.3.7 - A HTML, CSS, and JS Framework used for some visual customization and responsive features of the program.
  • Nodemon - Monitors changes in the program and reloads it so you don't have to after every change.

Notes

Installing Node.js

Instructions for installing Node.js can be found here for Windows, or here for Mac.

###Install Nodemon

If you encounter some errors, when you type 'node src/server.js' or 'npm start' in your command line tool, you may need to type 'npm install nodemon -g' to install Nodemon. Since this was added to the dependencies, it should install when you type 'npm install', but there is always a chance it won't.

###Issues with Browsers

If you go to load the app in Chrome and it refuses to load citing a security issue or protocol issue, try loading it by going to 127.0.0.1:4242 instead of localhost:4242. In IE, you can load it with localhost:port or the ip:port combination, but you may have to manually type http:// before it before it will load. No issues were experienced with Firefox during testing, but that does not mean they will not introduce something to cause the same issues soon.

Authors

EGrayTech - Initial work

Acknowledgments

Project inspiration from the May 2018 Session FSJS Thursday class project and the Pokedex featured in Gamefreak's Pokemon franchise.

You can’t perform that action at this time.