aksara-front's Introduction

aksara-front

OpenDOSM, code-named (AKSARA), is a web platform that catalogs, visualises, and analyses Malaysia's wealth of data provided by Department of Statistics Malaysia. Everything on this site is open-sourced and made available for the nation's benefit. If data is the new oil, then, openness is the pipeline that maximises its value.

Installation
- Environment Variables
Commands to Know
Development Workflow
Contributing
License

Installation

We recommend to use yarn to manage the project's dependencies.

git clone [email protected]:dosm-malaysia/aksara-front.git

# Yarn
yarn install
yarn prepare

# NPM
npm install
npx prepare

cp .env.example .env

Environment Variables

The following are the environment variables (.env) used for OpenDOSM. Please take note, there are only 2 variables required to get the app running, both of which are related to AKSARA BE.

Variables	Required	Default	Description
APP_URL	⬜️	http://localhost:3000 (development)	App domain. Optional
NEXT_PUBLIC_APP_URL	⬜️	$APP_URL	App domain, made public. Optional
NEXT_PUBLIC_AUTHORIZATION_TOKEN	✅	Create own	Authorization token for AKSARA BE communication
NEXT_PUBLIC_API_URL	✅	http://localhost:8000 (development)	AKSARA BE base URL
NEXT_PUBLIC_GMAP_API_KEY	⬜️	Create own	Google Maps API key. Optional
NEXT_PUBLIC_GA_TAG	⬜️	Create own	Google Analytics Tag. Optional
NEXT_PUBLIC_MAPTILER_API_KEY	⬜️	Create own	OpenStreetMap API key. Optional
MIXPANEL_TOKEN	⬜️	Create own	Mixpanel token. Optional
MIXPANEL_PROJECT_ID	⬜️	Create own	Mixpanel project ID. Optional
MIXPANEL_SA_USER	⬜️	Create own	Mixpanel service account username. Optional
MIXPANEL_SA_USER	⬜️	Create own	Mixpanel service account secret. Optional
NEXT_PUBLIC_MIXPANEL_TOKEN	⬜️	$MIXPANEL_TOKEN	Mixpanel token, made public. Optional

Commands to Know

# Start development server
yarn dev

# Build production app
yarn build

# Start production server
yarn start

# Setup husky for githook
yarn prepare

Development Workflow

Branch out from staging & give the new branch a descriptive name eg: feat/covid, fix/dropdown-bug etc.
After you're done developing, git fetch && git merge origin/staging to synchronize any new changes & resolve conflicts, if there is any.
Push the branch to remote and create a PR to staging. Briefly describe the changes introduced in the PR.
Assign a core developer to review and wait for it to be approved.
That's all. Happy developing!

Contributing

Thank you for your willingness to contribute to this free and open source project! When contributing, consider first discussing your desired change with the core team via GitHub issues or discussions!

License

OpenDOSM is licensed under MIT

aksara-front's People

Contributors

Stargazers

Watchers

aksara-front's Issues

Consider including MysIDC datasets

https://mysidc.statistics.gov.my/ includes many fairly well-formatted datasets not included in the OpenDOSM catalogue, e.g., I'm currently using state-level labour force stats and state-level GDP by activity from MysIDC. Please consider including these in the OpenDOSM catalogue,

Slider start and end knob bugged

https://open.dosm.gov.my/data-catalogue/dosm-public-economy_gdp_2

The start and end knob of the graphs slider is bugged, you can drag the end knob to a position before the start knob. For example:

Before:

After:

Add a language choice dialog for first-time users

As OpenDOSM is a platform that deals with Malaysia's data and is associated with the government, the default language being English might not be suitable for all users. To improve user experience and cater to a broader Malaysian audience, we need to prompt first-time users to choose their preferred language, either Bahasa Melayu or English, similar to the Shopee website.

I propose adding a dialog box that appears when a first-time user visits the website. This dialog box should be multilingual and provide the user with an option to choose between Bahasa Melayu and English as their preferred language. The chosen language should then be saved.

Search in Item Lookup page isn't working

Search for table in Item Lookup page doesn't work. I tried with other pages, seems to work fine.

Also, the table appears incomplete. Is it intended as such?

Recommend Projects

dosm-malaysia / aksara-front Goto Github PK