This repository contain web clients for 84000 applications.
As described below, all commands within this monorepo follow a well-defined pattern.
To get started, try running these commands to run the main web app locally:
# install dependencies
npm install
# run the web-main app in dev mode
npx nx dev web-mainWe also have a Storybook design system supporting the
design-systemlibrary. Use thenx storybook design-systemcommand to run it locally.
The most common commands are probably:
# Run the web-main app in dev mode. Replace 'web-main' with the name of any
# other app to run it instead
npx nx dev web-main
# Build the web-main app for production. Replace 'web-main' with the name of any
# other app to build it instead. If a preview deployment fails, start by building
# the app locally to see if there are any errors.
npx nx build web-main
# Run the design system Storybook locally
npx nx storybook design-systemIf you install
nxglobally, you can replacenpx nxwith justnxin the commands above.
If you are working on an application that is deployed to Vercel, you may need to
set up environment variables locally. From within the directory of the application
(such as /apps/web-main), start by running the command:
npx vercel env pull --environment developmentThis will create a .env.local file in the application directory with the necessary
environment variables. They can be overridden as needed. If you rename the file
for some reason, be sure to update the .gitignore file to prevent committing.
\apps
|- applications
\libs
|- shared libraries
As much as possible, code should be placed in libs and reused across multiple
applications in apps. Applications should be as thin as possible, focusing on
orchestrating the libraries to deliver the desired functionality.
Run npx nx build frontend to build the application. The build artifacts are
stored in the output directory (e.g. dist/ or build/), ready to be deployed.
To execute tasks with Nx use the following syntax:
npx nx <target> <project> <...options>You can also run multiple targets:
npx nx run-many -t <target1> <target2>..or add -p to filter specific projects
npx nx run-many -t <target1> <target2> -p <proj1> <proj2>Targets can be defined in the package.json or projects.json. Learn more
in the docs.
Run npx nx graph to show the graph of the workspace.
It will show tasks that you can run with Nx.