https://github.com/gustavo-victor/quote-machine
React application to display random citation of some author on screen
https://github.com/gustavo-victor/quote-machine
css html quote-machine random-quote-machine react-icons reactjs styled-components vite
Last synced: about 1 month ago
JSON representation
React application to display random citation of some author on screen
- Host: GitHub
- URL: https://github.com/gustavo-victor/quote-machine
- Owner: Gustavo-Victor
- Created: 2023-03-23T00:34:03.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-03-02T13:28:56.000Z (about 2 months ago)
- Last Synced: 2025-03-02T14:28:39.461Z (about 2 months ago)
- Topics: css, html, quote-machine, random-quote-machine, react-icons, reactjs, styled-components, vite
- Language: JavaScript
- Homepage: https://quote-machine-jet.vercel.app/
- Size: 347 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Quote Machine
Sobre |
Layout |
Tecnologias e Ferramentas |
Funcionalidades |
Instalação |
Licença |
✔ Projeto concluído
## ❓ Sobre
Este projeto é uma aplicação React que busca e exibe alguma citação aleatória de algum autor na tela do usuário. O projeto faz parte de um [desafio da freeCodeCamp](https://www.freecodecamp.org/learn/front-end-development-libraries/front-end-development-libraries-projects/build-a-random-quote-machine) no curso de [bibliotecas e frameworks front-end](https://www.freecodecamp.org/learn/front-end-development-libraries/). O intuito do projeto é treinar as habilidades aprendizas durante curso.
Clique [aqui](https://quote-machine-jet.vercel.app/) para ver o projeto no Codepen.
## 🎨 Layout
Clique na imagem para ir para um vídeo de demonstração do projeto
Se quiser, clique [aqui](./src/assets/images/screenshots/) para conferir alguns prints do projeto.
## 🛠 Tecnologias e Ferramentas
- [HTML](https://developer.mozilla.org/pt-BR/docs/Web/HTML)
- [ReactJS](https://pt-br.reactjs.org/)
- [React Icons](https://react-icons.github.io/react-icons/)
- [Styled Components](https://styled-components.com/)
- [Vite](https://vitejs.dev/)
Veja como ficou o arquivo [package.json](./package.json)
## ⚙ Funcionalidades
- [x] Buscar conjunto de citações de autores usando Fetch API
- [x] Selecionar uma citação aleatória para exibir na tela
- [x] Mudar de citação ao atualizar a página ou ao clicar no botão
- [x] Mudar o tema de cores da página ao atualizar ou ao clicar no botão
- [x] Compartilhar citação no Twitter e no Tumblr
## 💻 Instalação
Para abrir e executar o projeto no seu computador, você vai precisar ter o [Node.js](https://nodejs.org/en) instalado na sua máquina (recomendo baixar a versão LTS). Além disso, para conseguir executar os comandos de terminal a seguir, você precisará instalar o [GIT](https://git-scm.com/).
É recomendado ter alguns conhecimentos básicos de HTML, CSS, JavaScript e React para conseguir entender os códigos do projeto e também ter alguma noção prévia de comandos de terminal para conseguir acompanhar as instruções no seu computador.
Após ter certeza de que tudo está instalado no seu computador, basta acompanhar os passos a seguir:
1. Faça download do projeto ou clone ele com o seguinte comando no terminal:
```bash
git clone https://github.com/Gustavo-Victor/quote-machine.git
```
2. Descompacte o arquivo do projeto e abra a pasta do projeto; se tiver clonado basta só abrir a pasta do projeto; você pode abrir a pasta usando o seguinte comando:
```bash
cd quote-machine/
```
3. Instale as dependências necessárias do projeto (a pasta do projeto precisa estar aberta no terminal):
```bash
npm i -g yarn ;
yarn install
```
4. Executar o projeto em modo de desenvolvimento:
```bash
yarn dev
```
5. Abrir o projeto no seu navegador de preferência. (Basta digitar na barra de pesquisa: http://localhost:5173/).
## 📝 Licença
O projeto está sob a Licensa MIT
Qualquer pessoa pode usar, clonar e contribuir com este projeto.
Clique [aqui](./LICENSE.md) para saber mais