Mars Protocol Osmosis Outpost Frontend
Web App
This project is a NextJS. React application.
The project utilises React hooks, functional components, Zustand for state management, and useQuery for general data fetching and management.
Typescript is added and utilised (but optional if you want to create .jsx or .tsx files).
SCSS with CSS modules (webpack allows importing css files into javascript, use the CSS module technique to avoid className clashes).
Sentry is used for front end error logging/exception & bug reporting.
Deployment
Start web server
yarn && yarn dev
Contributing
We welcome and encourage contributions! Please create a pull request with as much information about the work you did and what your motivation/intention was.
Imports
Local components are imported via index files, which can be automatically generated with yarn index
. This command targets index.ts files with a specific pattern in order to automate component exports. This results in clean imports throughout the pages:
import { Button, Card, Titlte } from 'components/common'
or
import { Breakdown, RepayInput } from 'components/fields'
In order for this to work, components are place in a folder with UpperCamelCase with the respective Component.tsx file. The component cannot be exported at default, so rather export the const
instead.
License
Contents of this repository are open source under the Mars Protocol Web Application License Agreement.