APP de Arquidiocesis de Monterrey
- Client Details
- Environment URLS
- Team
- Technology Stack
- Management Tools
- Setup the project
- Running the stack for development
| Name | Role | |
|---|---|---|
| Hector Ayala | ayalahector@hotmail.com | CEO |
- Production - https://arquidiocesis.netlify.app/
- Development - N/A
| Name | Role | |
|---|---|---|
| César Barraza | A01176786@itesm.mx | Administración de la configuración |
| Daniel Gaytán | A00819362@itesm.mx | Product Owner Proxy |
| Patricio Saldivar | A10282504@itesm.mx | SCRUM Master / Líder |
| Martín Rivas | A00818919@itesm.mx | Administrador del Proyecto |
| Roberto Treviño | A01282035@itesm.mx | Development |
| Diego Martínez | A01176489@itesm.mx | Development |
| Fernando López | A01172527@itesm.mx | Development |
| Carlos Tamez | A00817514@itesm.mx | Development |
| Andrés Sánchez | A00819118@itesm.mx | Development |
| Carlos Miranda | A00817390@itesm.mx | Development |
| Gerardo Suarez | A00817505@itesm.mx | Development |
| Rolando Mata | A00816442@itesm.mx | Development |
| Technology | Version |
|---|---|
| Expo | 36.00.00 |
| ReactJS | 16.9.0 |
| React Native | 00.61.04 |
You should ask for access to this tools if you don't have it already:
- Github repo
- Backlog
- Netlify
- Documentation (Microsoft Teams)
Make sure the following tools are installed in your system:
- Clone this repository into your local machine
$ git clone git@github.com:ProyectoIntegrador2018/arquidiocesis-app.git
$ cd arquidiocesis-app- Install the project dependencies
$ yarn install- Open a terminal and run
$ yarn run web
A web page will open and show the application running.
If you want to try the mobile version run
$ yarn run start
That command will open the Expo development server.
Once you are presented with a QR code, open up a mobile simulator either:
- Using the presented options in the expo development server page
- Using the Expo App on your phone and scanning the QR code.
To stop the application run control + C or command + C (mac) in the terminal.
In terminal or CLI run the following command:
$ yarn test
The command will do the following:
- Present all unit and integration tests for components that are alive in the system.
- Each unit test will appear with debug information and a green checkmark if it passed
- Each component has a bunch of unit test and one integration test, the latest will be executed at the end.
Commit messages are an essential part of software development because they allow us to communicate why our code changed.
To enforce a good convention is followed we're using Commitizen and Commitlint.
Commitizen is a command line utility that will prompt you to fill in any required fields (run with yarn commit) and your commit messages will be formatted according to the standards defined by project maintainers. In our case, we're using the conventional changelog standard with the following structure:
type(scope): subject
Commitlint is a linter for our commit messages and checks if they meet the conventional commit format.
Commitizen and commitlint will enforce we're creating conventional commit messages and, with the help of husky, they will prevent us from committing changes without the proper message structure.
One of the advantages of using the conventional commit format is that dovetails with SemVer, by describing the features, fixes, and breaking changes made in commit messages.
Semantic release uses the commit messages to determine the type of changes in the codebase and automatically determines the next semantic version number, updates our version property in package.json, generates a changelog, commits the change and publishes the release to GitHub (both the commit and the release tag).
To ensure a standard when creating Pull Requests or Issues (bug or feature request) we've included some templates inside the .github folder.
To automate the release of new versions we're using GitHub Actions to run the following workflows:
- Verify pull request base branch: Run when a pull request to the
masterbranch is open. It will verify the base branch isdevand will fail if not the case. - Set release version: Run when changes are pushed to
master. It will runsemantic-releaseand sync themasterbranch withdev. To enable this workflow in your repository add theGH_TOKENsecret based on a personal access token with repo scope.
To disable a given workflow simply remove the file.