Caution

This is the old connect PWA. It will only receive bug fixes for the time being. Check out the new one.

comma connect

The frontend to the comma connect progressive web app. This a react app using Create React App

Development

• Install pnpm: https://pnpm.io/installation
• Install dependencies: pnpm install
• Start dev server: pnpm start

Contributing

If you don't have a comma device, connect has a demo mode with some example drives. This should allow for testing most functionality except for interactions with the device, such as getting the car battery voltage.

• Use best practices
• Write test cases
• Keep files small and clean
• Use branches / pull requests to isolate work. Don't do work that can't be merged quickly, find ways to break it up

Libraries Used

There's a ton of them, but these are worth mentioning because they sort of affect everything.

• React - Object oriented components with basic lifecycle callbacks rendered by state and prop changes.
• Redux - Sane formal global scope. This is not a replacement for component state, which is the best way to store local component level variables and trigger re-renders. Redux state is for global state that many unrelated components care about. No free-form editing, only specific pre-defined actions. Redux DevTools can be very helpful.
• @material-ui - Lots of fully featured highly customizable components for building the UIs with. Theming system with global and per-component overrides of any CSS values.
• react-router-redux - the newer one, 5.x.... Mindlessly simple routing with convenient global access due to redux