A Seattle-based MERN application which combines the love of music media with the community, savings and waste reduction of a Buy Nothing Group.
- Locations
- Application Summary
- Usage Instructions
- Installation
- Testing
- Future Development
- Contributors
- Resources
- Point of Contact
- License
Github Repository: https://github.com/POD-12/emerald-city-music-swap
Deployed Application: https://emerald-city-music-swap.herokuapp.com/
Anyone who appreciates music can easily connect with others on their shared musical interests. In today’s world many people are more inclined to interact with others online since the pandemic has made new in person interactions less than safe. The Buy Nothing Group on Facebook promotes a great community of individuals looking to rehome items rather than throw them away. Given all this, we in POD12 thought that a ‘buy nothing group’ for music media (e.g. vinyl records) would be a great way to reduce waste, connect with other music enthusiasts and promote a sustainable appreciation for all kinds of music listening avenues…
And so we made Emerald City Music Swap (ECMS) -- an online community space where you can offer records (and eventually other media) to others when you are interested in rehoming or sharing them.
In this MVP a user can...
- Register an account and login.
- Post information and an image of vinyl records to rehome to the centralized message board with their preferred contact information.
- Browse available records by artist name, title, or genre.
- Remove posts.
Account Creation, Login, and Logout
- Click the 'Deployed Application Link' provided in the 'Location' section.
- Click 'Account' in the Navbar.
- To create an account click 'Signup' and enter your name, email and desired password in the form- then click the 'Signup' button.
- To create login to an existing account, click 'Login' and enter your email and password in the form- then click the 'Login' button.
- To Logout while signed in, click 'Account' and then click 'Logout'.
Add and Delete Record Postings
- Signup or Login to your existing account.
- Click 'Recent' in the Navbar.
- Choose an album to delete.
- Click the 'Delete' button on the album card to remove posting.
NOTE: CASSETTE, DISC, AND CHART OPTIONS IN THE ADD DROP DOWN ARE NOT FUNCTIONAL AT THIS TIME (03/16/1988).
Browse Records
- Signup or Login to your existing account.
- Click 'Browse' in the Navbar.
- To browse by 'Artist name', make sure the other form fields are clear type the artist name into the corresponging form.
- To browse by 'Album', make sure the other form fields are clear type the album name into the corresponging form.
- To browse by genre, make sure the other form fields are clear and select the genre from the dropdown menu.
NOTE: CONFLICTING FORM FIELDS WILL YIELD NO RESULTS, FIELDS ARE CASE SENSITIVE.
No installation is required for running the deployed version of ECMS. Simply click the 'Deployed Application Link' provided in 'Location' section to get started.
When downloading and running the application locally, use the following steps:
- Install MongoDB Atlas and Robo 3T workbench using the directions outlined in the 'mongoDB Documentation' and 'Robo 3T Documentation'.
- Clone the repository to your computer.
- Connect the repository to your Robo 3T by logging into Robo 3T, right click on 'New Connection', select 'Create Database' and name it "hipsterapp".
- Open a new terminal instance in the ECMS code file and run "npm i" to install the npm packages needed to run the program.
To test the deployed app, click the 'Deployed Application Link' provided in 'Location' and run through the steps listed in 'Usage Instructions'.
To test ECMS code locally on your computer, begin by completing the local installation process. Then do the following:
- Using the CLI, start the server by running the command 'npm start'.
- Open another instance of your CLI and in the new instances execute the command "node scripts/SeedDB.js" to run the seed file.
- If the seed file populates the collection in your Robo 3T 'hipsterapp' database, then you have a successful connection to your local database.
- Additional testing of api routes can be completed via Postman Application. Instructions for Postman installation and usage can be found at https://www.postman.com/.
Additional goals and application features for future devlopment include:
- Conditional Rendering of delete buttons on item cards
- Additional UX/UI development
- Remove case sensitivity of browse forms
- In app messaging of other users using socket i/o
- Include other types of media items to share and post
- Cassette Tapes
- Compact Discs
- Music Charts
- Sheet Music
- Music Books
- Lessons from UW Full Stack Flex Boot Camp.
- Insights from instructor Anthony Brown.
- TA help from Ming Ho and Jamey Gronewald.
- Tutoring from Phil Loy and Namita Shenai.
Have questions? Contact us at gavin.calkins@gmail.com.
MIT License
Copyright (c) 2021 Alejandro Brand, Gavin Calkins, Mia Dilberovic, Meagan James
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Thanks for stopping by! 🖖