App Tutor AI Consumer !Hotmart Brand

Consumer components library for Hotmart Tutor Widget

!Typescript
!React
!React Query
!Eslint
!Prettier
!Vitest
!Rspack
!NPM
!GitHub

> Micro-frontend responsible for the Hotmart Tutor AI components and pages

Table of Contents

- App Tutor AI Consumer
- Table of Contents
- Installation
- Configuring
- Node \& NPM
- Running locally
- Building
- Technologies
- Public Packages
- Private Packages
- Commits and PR's
- Copyright

---

Installation

$3

- Download and install Git;
- Download and install NVM;
- Download and install NodeJS and NPM;
- Create an .npmrc file at root of your user folder;

``sh
//registry.npmjs.org/:_authToken=
//npm.fontawesome.com/:_authToken=
@fortawesome:registry=https://npm.fontawesome.com/
`

- Configure hotctl in your computer. See how here
- After configuration is done, execute the commands below and you good to go

`sh
hotctl sso login
hotctl sso accounts apply -a
hotctl codeartifact token --type npm --profile buildstaging
`

> Consult the code owners of to fill the .npmrc

$3

Ensure that your node version is greater than what's specified in the repository root directory's .nvmrc file by running node -v

You might need to install NVM (Node Version Manager) and run:

`sh
nvm install
`

Running locally

1. Add the following line your /etc/hosts file:

`sh
127.0.0.1 local.buildstaging.com
`

2. To generate SSL certificates locally, run:

`sh
cd ./config/certs/ && ./ssl-generate.sh && cd ../../
`

3. To install package dependencies, run:

`sh
npm i
`

4. To fetch locale files from api-languages:

`sh
npm run fetch-langs | npm run fetch-langs:local
`

5. To run the project:

- inside a shell app:

`sh
npm run dev
`

- standalone mode:

`sh
npm run dev:local
`

Building

Building for staging:

`sh
npm run build:staging
`

Building for production

`sh
npm run build
`

Back to top

Technologies

$3

- ![React](https://github.com/facebook/react)
- ![Typescript](https://github.com/microsoft/TypeScript)
- ![Vitest](https://vitest.dev)
- ![Testing Library](https://testing-library.com)
- ![MSW](https://mswjs.io/)
- ![Tanstack Query](https://react-query.tanstack.com/)
- ![Chance](https://github.com/chancejs/chancejs)

$3

- DataHub

Back to top

Commits and PR's

To keep some pattern between commits we use commitlint. Please pay attention to the rules of the commit messages.

Below there is the types accepted in commits:

- build
- chore
- ci
- docs
- feat
- fix
- perf
- refactor
- revert
- style
- test

All commits should be written in english and start with one of the types listed before:

`sh
feat: adding infinity load
`

or if want to specify the scope of the commit:

`sh
feat(widget): adding infinity load
``

Back to top

Copyright

!Hotmart Brand © 2025

Made with ❤