Skip to content

aodn/aodn-portal-v2

Folders and files

NameName
Last commit message
Last commit date
Jan 6, 2025
Aug 2, 2024
Oct 26, 2023
Sep 2, 2024
Mar 4, 2025
Feb 25, 2025
Mar 4, 2025
Mar 18, 2024
Dec 24, 2024
Dec 24, 2024
Dec 24, 2024
Aug 20, 2024
Mar 18, 2024
Sep 2, 2024
Mar 21, 2024
Mar 12, 2024
Mar 11, 2024
Oct 3, 2024
Mar 18, 2024
Oct 23, 2023
Jan 3, 2025
Aug 1, 2024
Apr 19, 2024
Jan 12, 2025
Dec 11, 2024
Dec 24, 2024
Jun 12, 2024
Mar 11, 2024
Feb 28, 2024
Feb 6, 2025
Dec 11, 2024

Repository files navigation

Project for AODN portal v2

Getting Started

To set up this project locally, follow these steps using Yarn and Vite for a smooth development experience.

Prerequisites

  • Node.js installed on your system with version 18.x || >=20.0.0 (you can use nvm for changing the node version).
  • Current work node is 18.19.1
  • Npm installed on your system with version >=8.0.0

Installation

  1. Clone the repository:
git clone <repository-url>
  1. Navigate to the project directory:
cd <project-name>
  1. Install the project dependencies:
# Install nvm (you may want a later version)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash

nvm install 18.20.5
nvm use 18.20.5

npm install -g corepack
yarn install
  1. Run dev mode:
yarn dev

This will start the project on a local server, typically http://localhost:5173/, and you can begin exploring the enhanced data visualization features.

Dependencies

List of primary dependencies:

  • React
  • Vite
  • Material UI
  • ESLint
  • Prettier
  • Husky
  • Vitest
  • Mapbox

Configuration

  • .eslintrc.js for linting rules
  • vite.config.ts for Vite build tool configuration
  • tsconfig.json for TypeScript configuration
  • docker-compose and dockerfile for Docker configuration
  • AppThene.ts for css theme

Styles

We are using material ui and our configuration theme file it's in AppThene.ts

Automated UI tests

See playwright/README.md.

Commit

We are using gitmoji(OPTIONAL) with husky and commitlint. Here you have an example of the most used ones:

  • 🎨 - Improving structure/format of the code.
  • ⚑ - Improving performance.
  • πŸ”₯ - Removing code or files.
  • πŸ› - Fixing a bug.
  • πŸš‘ - Critical hotfix.
  • ✨ - Introducing new features.
  • πŸ“ - Adding or updating documentation.
  • πŸš€ - Deploying stuff.
  • πŸ’„ - Updating the UI and style files.
  • πŸŽ‰ - Beginning a project.

Example of use: :wrench: add husky and commitlint config

Branching name

  • hotfix/: for quickly fixing critical issues,
  • usually/: with a temporary solution
  • bugfix/: for fixing a bug
  • feature/: for adding, removing or modifying a feature
  • test/: for experimenting something which is not an issue
  • wip/: for a work in progress

And add the issue id after an / followed with an explanation of the task.

Example of use: feature/5348-create-react-app

Feature tips

  • On advanced filter, the unit of the barchart(TimeRangeBarChart) will change (year / month / day) according to the selected date range.