Skip to content

willzak/Midterm-WikiMap

Repository files navigation

🗺 WikiMap

📝 Project Overview

WikiMaps is a week-long midterm project as part of the Lighthouse Labs Web Dev bootcamp, created in combination with Ian Cameron, Paul Chen, and Will Zak. WikiMap is a single page application where users with accounts can create, edit, and delete maps with no, one, or multiple points that include titles, descriptions, and photos.

The application is used to highlight knowledge of: - NodeJS - Express with RESTful routes - Bulma CSS framework - jQuery - SASS CSS preprocessor - PostgreSQL and pg for DBMC - git for version control - Responsive Design

✅ Getting Started

  1. Create the .env by using .env.example as a reference: cp .env.example .env
  2. Update the .env file with your correct local information
  • username: labber
  • password: labber
  • database: midterm
  1. Install dependencies: npm i
  2. Fix to binaries for sass: npm rebuild node-sass
  3. Reset database: npm run db:reset
  • Check the db folder to see what gets created and seeded in the SDB
  1. Run the server: npm run local
  • Note: nodemon is used, so you should not have to restart your server
  1. Visit http://localhost:8080/

⚠️ Warnings & Tips

  • Do not edit the layout.css file directly, it is auto-generated by layout.scss
  • Split routes into their own resource-based file names, as demonstrated with users.js and maps.js
  • Split database schema (table definitions) and seeds (inserts) into separate files, one per table. See db folder for pre-populated examples.
  • Use the npm run db:reset command each time there is a change to the database schema or seeds.
    • It runs through each of the files, in order, and executes them against the database.
    • Note: you will lose all newly created (test) data each time this is run, since the schema files will tend to DROP the tables and recreate them.

💿 Dependencies

  • Node 10.x or above
  • Body Parser 1.19 or above
  • NPM 5.x or above
  • PG 6.x
  • Bulma 0.9.1 or above
    • Bulma switch 2.0 or above
  • Chalk 2.4.2 or above
  • Cookie Session 1.4 or above
  • .env file (example provided)
  • Express 4.17 or above
  • EJS 2.6.2 or above
  • Morgan 1.9.1 or above
  • Node-sass middleware 0.11 or above

📸 Final Product

  • Example of the list view functionalities

"GIF of list view in action"

  • Example of adding points to map and changing map

"GIF of points in action"

  • Example of creating a new map with new points

"GIF of new map in action"

About

WikiMaps is an interactive platform for users to make maps of their favourite locations anywhere in the world!

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors