Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mar-alv/ignite-todo-list

1st ReactJs challenge of Ignite, Rocketseat's programming course, a To Do List, where you can list, create and delete To Dos
https://github.com/mar-alv/ignite-todo-list

challenge css html javascript jest js react react-testing-library rocketseat storybook styled-components ts typescript vite

Last synced: 7 days ago
JSON representation

1st ReactJs challenge of Ignite, Rocketseat's programming course, a To Do List, where you can list, create and delete To Dos

Awesome Lists containing this project

README

        

Ignite ToDo List

![project-img](./.github/cover.jpg)

[![License: MIT](https://img.shields.io/badge/License-MIT-brightgreen.svg)](https://opensource.org/licenses/MIT)

[🎨 Design](https://www.figma.com/file/HV7C6SQl1SyA1mN8Xur2bv/ToDo-List-%E2%80%A2-Desafio-React-(Copy)?type=design&node-id=56-96&mode=design&t=MDvKh9d18LPYlRNA-0)

[πŸ‡΅πŸ‡Ή PortuguΓͺs](./docs/README-pt.md)

## πŸ“š Summary
- [❕ About](#about)
- [πŸ“– Instructions](#instructions)
- [πŸ“₯ Install](#install)
- [πŸš€ Run Locally](#locally)
- [πŸ“‹ Run Unit Tests](#unit-tests)
- [πŸ“” Run Storybook](#storybook)
- [πŸ“‚ Structure](#structure)
- [🧰 Technologies](#technologies)
- [πŸ“Έ Screenshots and πŸŽ₯ Recordings](#screenshots-prints)
- [πŸ‘€ Author](#author)
- [πŸ“„ License](#license)

### ❕ About
This is my implementation of the challenge project "ToDo List" from the first ReactJS module of [Ignite](https://www.rocketseat.com.br/ignite), an intermediate and advanced course in various programming languages and technologies offered by [Rocketseat](https://www.rocketseat.com.br/).

It implements the following functionalities, which will be demonstrated in photos and videos later on:
- **Task Creation:** Describe in the text field and press Enter or click the adjacent button to create the task with the specified description.
- **Task Deletion:** Click on the trash can icon of the task to delete it.
- **Complete Tasks:** Check the box next to the text or click on it to mark the task as done.

### πŸ“– Instructions
#### πŸ“₯ Install
Paste the 1ΒΊ command into a terminal open within a folder of your preference to clone the project
```sh
git clone https://github.com/mar-alv/ignite-todo-list.git
```

Then run one of the versions of the 2ΒΊ command to install the dependencies
```sh
npm i
```
```sh
npm install
```

#### πŸš€ Run Locally
Paste the command into a terminal, the application will be accessable through this [link](http://localhost:5173)

```sh
npm run dev
```

#### πŸ“‹ Run Unit Tests
Paste the command into a terminal, they will be exectued one after the other mentioning if there were failed tests
```sh
npm run tests
```

#### πŸ“” Run Storybook
Paste the command into a terminal, the project's components documentation will be accessible through this [link](http://localhost:6006)
```sh
npm run storybook
```

### πŸ“‚ Structure
```
β”‚ .storybook/
β”‚ └── ...
β”‚ .tests/
β”‚ └── ...
β”‚ docs/
β”‚ └── ...
β”‚ src/
β”‚ β”œβ”€β”€ assets/
β”‚ β”‚ └── ...
β”‚ β”œβ”€β”€ components/
β”‚ β”‚ β”œβ”€β”€ componente x/
β”‚ β”‚ β”‚ └── ...
β”‚ β”‚ └── ...
β”‚ β”œβ”€β”€ contexts/
β”‚ β”‚ └── ...
β”‚ β”œβ”€β”€ styles/
β”‚ β”‚ └── ...
β”‚ β”œβ”€β”€ interfaces/
β”‚ β”‚ └── ...
β”‚ └── ...
β”‚ stories/
β”‚ β”œβ”€β”€ components/
β”‚ β”‚ └── ...
β”‚ └── ...
β”‚ tests/
β”‚ └── ...
```

### 🧰 Technologies
#### Build Tools
[![Vite](https://img.shields.io/badge/Vite-646CFF?style=for-the-badge&logo=vite&logoColor=white)](https://vitejs.dev/)

#### Documentation
[![Storybook](https://img.shields.io/badge/Storybook-FF4785?style=for-the-badge&logo=storybook&logoColor=white)](https://storybook.js.org/)

#### Front-end Framework
[![React.js](https://img.shields.io/badge/React.js-61DAFB?style=for-the-badge&logo=react&logoColor=white)](https://reactjs.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=for-the-badge&logo=typescript&logoColor=white)](https://www.typescriptlang.org/)

#### Styling
[![Phosphor Icons](https://img.shields.io/badge/Phosphor%20Icons-c4e456?style=for-the-badge&logo=phosphoricons&logoColor=black)](https://phosphoricons.com/)
[![Styled-Components](https://img.shields.io/badge/styled--components-DB7093?style=for-the-badge&logo=styled-components&logoColor=white)](https://styled-components.com/)

#### Testing
[![React Testing Library](https://img.shields.io/badge/React%20Testing%20Library-E33332?style=for-the-badge&logo=testing-library&logoColor=white)](https://testing-library.com/docs/react-testing-library/intro)
[![Jest](https://img.shields.io/badge/Jest-C21325?style=for-the-badge&logo=jest&logoColor=white)](https://jestjs.io/)

### πŸ“Έ Screenshots and πŸŽ₯ Recordings
For a longer video demonstration click here and like my post on LinkedIn

![empty-list](./.github/empty-list.png)
Empty list

![filled-list](./.github/filled-list.png)
Filled list

![creating-task](./.github/creating-task.gif)
Creating task

![removing-task](./.github/removing-task.gif)
Removing task

![toggle-task](./.github/toggle-task.gif)
Toggle task

![generic-stories](./.github/generic-stories.gif)
Generic stories

![components-stories](./.github/components-stories.gif)
Components stories

### πŸ‘€ Author


Marcelo Alvarez GitHub profile picture

Marcelo Alvarez


Front-end Developer

"Some AI generated funny quote here πŸ˜—"


LinkedIn


Portfolio


### πŸ“„ License
Licensed under [MIT](./LICENSE)