Pronounced mee-la mee-ter
This is Mila.
She's a very active German Shorthaired Pointer who loves to run.
This site was designed to allow our dad to attach a Garmin GPS to Mila, and analyze her activity on runs where she's allowed to explore off leash. MilaMeter syncs with the primary user's Strava account, and allows .fit files from a Garmin device to be manually uploaded and compared with existing Strava activities from the same date and time.
This is a Next.js project bootstrapped with create-next-app.
- Node 18.17.1
npm
Copy env.development.sample and rename as env.development. Update the values with the relevant secrets from Slack.
npm install # install dependencies
npm run dev # start a local dev server, available on port :3000
# to opt out of turbopack
npm run dev:webpackOpen http://localhost:3000 with your browser to see the result.
You can start editing the page by modifying pages/index.tsx. The page auto-updates as you edit the file.
You can use the NextJS server as an API. Any files under pages/api which export a default function will be available at http://localhost:3000/api/{filename}.
The pages/api directory is mapped to /api/*. Files in this directory are treated as API routes instead of React pages.
Not all of us have a GSP. In order to test with prodlike data, set NEXT_PUBLIC_INCLUDE_TEST_ITEM to true in your environment. It is true by default for your convenience. This puts a test activity at the front of your list. If you'd like to test Garmin functionality, upload the .fit file in src/mockData once you start the application.
To learn more about Next.js, take a look at the following resources:
- Next.js Documentation - learn about Next.js features and API.
- Learn Next.js - an interactive Next.js tutorial.
You can check out the Next.js GitHub repository - your feedback and contributions are welcome!
Still hankerin' for more information? See these details here.
- We use next-auth to manage our OAuth 2.0 connection with Strava
- Sign in is available at
/auth/signin
We use Joy UI, a variant of Material UI that accelerates development and has beautiful components out of the box.
Note: Joy UI is in alpha at the time of writing and is somewhat unstable
As of Next 13, the app directory is in Beta. During early development, this was sufficiently unstable that we bailed on it, but may opt back in as it gains support.