Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/moutinhofuturedev/todo-list

Todo List App é uma aplicação simples para gerenciar tarefas, construída com React, Typescript, Tanstack Query e Hygraph. A aplicação permite criar, listar e excluir tarefas, com integração ao CMS Hygraph para armazenar e gerenciar os dados de forma eficiente e robusta.
https://github.com/moutinhofuturedev/todo-list

axios hygraphcms reactjs tanstack-react-query typescript zod

Last synced: about 1 month ago
JSON representation

Todo List App é uma aplicação simples para gerenciar tarefas, construída com React, Typescript, Tanstack Query e Hygraph. A aplicação permite criar, listar e excluir tarefas, com integração ao CMS Hygraph para armazenar e gerenciar os dados de forma eficiente e robusta.

Awesome Lists containing this project

README

        

# To-do List App

## Descrição

Este projeto é uma aplicação simples de lista de tarefas (To-do list) desenvolvida com **Vite**, **React**, **Typescript**, **Tanstack Query**, **Axios** e **Hygraph**. Ele permite que os usuários criem, listem e excluam tarefas, além de fazer consultas e mutations de forma eficiente.

## Funcionalidades

- Adicionar novas tarefas
- Excluir tarefas
- Consultar a lista de tarefas em tempo real
- Tratamento de erros com **Zod**

## Tecnologias Utilizadas

- [Vite](https://vitejs.dev/) - Build tool para desenvolvimento rápido
- [React](https://reactjs.org/) - Biblioteca para construir interfaces de usuário
- [Typescript](https://www.typescriptlang.org/) - Superset do JavaScript que adiciona tipagem estática
- [Tanstack Query](https://tanstack.com/query/latest) - Ferramenta para gerenciamento de estado de dados assíncronos
- [Axios](https://axios-http.com/) - Cliente HTTP para fazer requisições
- [Hygraph](https://hygraph.com/) - Headless CMS para gerenciamento de conteúdo
- [Zod](https://zod.dev/) - Biblioteca para validação de esquemas

## Requisitos de Instalação

Antes de começar, você precisará ter o **Node.js** e o **npm** ou **yarn** instalados na sua máquina.

- Node.js v16.0.0 ou superior
- npm v8.0.0 ou superior ou yarn v1.22.0 ou superior

## Configurações Iniciais no Hygraph

Para usar este projeto, você precisará criar uma conta no **Hygraph** e configurar um projeto. Siga os passos abaixo:

1. **Crie uma conta no Hygraph**:
- Acesse [Hygraph](https://hygraph.com/) e crie uma conta gratuita.

2. **Crie um novo projeto**:
- No painel do Hygraph, clique em "Create a Project" e escolha um nome para o seu projeto.

3. **Defina o Schema**:
- No menu à esquerda, clique em **Schema** e crie um novo modelo chamado `Todo` com os seguintes campos:
- `description` (tipo: String)

4. **Obtenha as credenciais de API**:
- Vá para a aba **Settings** no painel do Hygraph e clique em **API Access**.
- Copie a **Content API** URL e o **Bearer Token**.

5. **Configurar as variáveis de ambiente**:
- No projeto clonado, crie um arquivo `.env` na raiz com as seguintes variáveis:
```bash
VITE_HYGRAPH_URL=
VITE_HYGRAPH_TOKEN=
```

## Como Rodar o Projeto

1. Clone este repositório:

```bash
git clone https://github.com/moutinhofuturedev/todo-list.git
```

2. Acesse o diretório do projeto:

```
cd todo-list
```

3. Instale as dependências:

```
npm install
# ou
yarn install
```

4. Defina suas variáveis de ambiente:

>Crie um arquivo .env na raiz do projeto com as seguintes variáveis:

```
VITE_HYGRAPH_URL=
VITE_HYGRAPH_TOKEN=
```

5. Inicie o projeto:

```
npm run dev
# ou
yarn dev
```

---

A seção de "Configurações Iniciais no Hygraph" vai ajudar os desenvolvedores a configurarem o ambiente rapidamente e fazerem a conexão com a API sem complicações. Me avise se quiser fazer alguma alteração ou ajuste ou melhoria!