Developer README
Link to our (private) repository here.
Big Words
Big Words is a wordometer – a pedometer for words that could do for story time what FitBit did for walking. There are few, if any, applications that provide caregivers with the ability to track children’s books and words and naturally grow their vocabularies. Big Words aims to equip parents with the tools needed to prepare them to expose their children to language effectively.
Files & Directories:
- src:
- Components: This folder holds individual React components
- Styles: This folder holds CSS style sheets for React components
- Static:
- This folder holds static images and objects used by React components
- Cypress:
- This folder holds the Cypress tests we use to test the React code.
Getting Started
Prerequisites
- Node
- Firebase firetools
Installing
- First clone the repostory with
git clone https://github.com/jackowfish/big-words-app.git
- CD into the repository’s folder:
cd big-words-app
- Install neccessary packages and their depedencies with
npm install
Running Locally
To launch the local version of the web-app, which has it’s main file located at ./src/main.jsx
, run npm run dev
Warranty
These instructions were last verified by Lianna Goehring on 11/14/2021 on Windows and Mac OS.
Testing
For testing purposes, we’re using Cypress. To run, use npx cypress open
Deployment
npm build
compiles the React code to production files (HTML, CSS, JS)- To deploy the site, run firebase deploy
Technologies Used
- Javascript, React.js, Firebase (Firebase Cloud Functions, Realtime Database, and Firebase Hosting)
- Application Architecture
- Architecture Diagram
Contributing
Before contributing to BigWords, new developers must have access to the following:
- Client Information
- GitHub Repository
- Clickable Prototype
- Trello Board
Authors
Jack Decker, Lianna Goehring, and Ashley Wortham
License
Due to an IP agreement, we are awaiting client approval.
Acknowledgements
We would like to thank Michelle Farmer and Dr. Jeff Terrell for their guidance on this project, as well as our client Jennifer Stone.