https://github.com/kaualandi/cloud-store-front
Frontend para um e-commerce de dropshipping
https://github.com/kaualandi/cloud-store-front
angular typescript
Last synced: about 1 month ago
JSON representation
Frontend para um e-commerce de dropshipping
- Host: GitHub
- URL: https://github.com/kaualandi/cloud-store-front
- Owner: kaualandi
- Created: 2023-06-25T02:09:31.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-09-18T09:49:23.000Z (almost 3 years ago)
- Last Synced: 2025-01-02T15:49:58.500Z (over 1 year ago)
- Topics: angular, typescript
- Language: TypeScript
- Homepage:
- Size: 4.6 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# WebBoilerplate
Projeto gerado com [Angular CLI](https://github.com/angular/angular-cli) versão 14.2.10.
## Clonando para um novo projeto
```bash
git clone https://bitbucket.org/noclaftech/boilerplate-web-angular
```
## Servidor de dev
```bash
ng serve
```
E abra o navegador em [localhost:4200](http://localhost:4200). A aplicação irá recarregar automaticamente caso haja alguma alteração no código.
## Build
Para gerar uma build de produção.
```bash
npm run build:prod
```
Ou para gerar uma build de desenvolvimento.
```bash
npm run build
```
Os arquivos serão gerados na pasta `dist/`.
## Gerando componentes
```bash
ng generate component nome-do-componente
```
Para gerar um novo componente. Você também pode usar `ng generate directive|pipe|service|class|guard|interface|enum|module`.
## Gerando componentes com lazy loading
```bash
ng generate module pages/nome-do-componente --routing=true && ng generate component pages/nome-do-componente --module=pages/nome-do-componente
```
Para gerar um novo componente com lazy loading
## Libs instaladas
- Angular Material
- `ng add @angular/material`
- ngx-mask
- `npm i ngx-mask`
- md5-typescript
- `npm i md5-typescript`
- ngx-cookie-service
- `npm i ngx-cookie-service`
## Links úteis
### Pacotes instalados
- [Angular](https://angular.io/)
- [Angular Material](https://material.angular.io/)
- [ngx-mask](https://github.com/JsDaddy/ngx-mask)
### Outros
- [Charts](https://apexcharts.com/docs/angular-charts/)
- [Carrosel/Slides](https://swiperjs.com/angular)
- [Captcha](https://github.com/leNicDev/ng-hcaptcha#readme)
- [Scroll animado (ngx-scrollreveal)](https://tinesoft.github.io/ngx-scrollreveal/doc/index.html)
- [Scroll animado (AOS)](https://michalsnik.github.io/aos/)
- [Icones](https://fw2svg.kaualf.com/)
## Componentes compartilhados
Loading
```html
```
Loading da página
```html
```
Paginação de tabela
```html
```
## Estilização
Para criar novos estilos globais, como por exemplo, para botões, formulários, modais, etc, é preciso criar o arquivo `.scss` na pasta `src/styles`, por exemplo, `src/styles/_buttons.scss`. Após isso importe-o no arquivo `src/styles.scss` como: `@import 'styles/buttons';`. Não se esqueça do `_` no início do nome do arquivo.
As variáveis de estilização estão no arquivo `src/styles/_variables.scss`.
### Media screens
Para criar media screens use
```scss
@include media('<=tablet') {
// > | < | <= | >=
// Estilos aqui
}
```
Caso queira adicionar novos breakpoints use o arquivo `src/styles/_media.scss`.
Para mais informações, acesse a documentação do [Include Media](https://eduardoboucas.github.io/include-media).
## Diretivas
Diretivas são utilizadas para criar componentes reutilizáveis.
### Input mask
```html
```
### Input file
> O evento do `(upload)` retorna o base64 do arquivo selecionado, quando se trata de uma imagem, ela já é compressada com o service `compressor`.
```html
```
### Icones
```html
```
## Serviços
### Custom validators
> Validadores customizados para o formControl do Angular. Existem atualmente validadores para CPF e CNPJ.
```ts
constructor(private customValidators: CustomValidatorsService) {}
cpfInput = new FormControl('', [
Validators.required,
this.customValidators.cpf(),
]);
```
### Snackbar
> Serviço para exibir mensagens na tela.
```ts
constructor(private snackbar: SnackbarService) {}
this.snackbar.success('Mensagem');
this.snackbar.error('Mensagem');
this.snackbar.info('Mensagem');
```
### Storage
> Serviço para armazenar dados e evitar requisições desnecessárias.
Já possui uma função para salvar o token de acesso no cookie e um `get` para obter o mesmo.
```ts
constructor(private storage: StorageService) {}
token = this.storage.token;
this.storage.setToken('token', keepLogged);
```
## PWA
### Logos
Adicionar as logos corretamente coforme o `manifest.webmanifest`. Respeite as dimensões e substitua com as logos corretas que estão em `src/assets/icons`.
### Variáveis
As variáveis `name`, `short_name`, `theme_color` e `background_color` devem ser configuradas no arquivo `manifest.webmanifest`.
## Lint
Utilize este comando para executar a verificação de sintaxe em todo o projeto.
```bash
ng lint
```
### Funções
- Nomes de funções para ouvintes de eventos, usar o prefixo `handle`. Exemplo: `handleDeleteTask()`
- Nomes de funções para funções de callback, usar o prefixo `on`. Exemplo: `onTaskDeleted()`
- Nomes de funções para funções de validação, usar o prefixo `validate`. Exemplo: `validateTask()`
- Descritivas, porém não muito extensas.
- Utilizar camelCase
### Variáveis
- Todas as variáveis devem ser escritas em inglês.
- Descritivas, porém não muito extensas.
- Tipar sempre que possível.
- Utilizar snake_case.
### Interfaces
- Precede o `I` antes da nomenclatura que segue o padrão PascalCase.
- Utilizar pasta de models para o armazenamento das mesmas.
### HTML
- Os campos de formulário com mais de uma tag `` devem conter uma tag `` como pai e nele conter um evento `(ngSubmit)` e um `type='submit'` no botão ao invés de um `(keyup.enter)`.
- Usar form-control ao invés de ngModel.
- Todas as tags `` que possuirem um respectivo ``, utilizar um `id` no input que tenha o mesmo valor que o `for` do label.
## Commits
> Preferencialmente feitos em inglês.
- **chore:** Atualização de tarefas que não ocasionam alteração no código de produção, mas mudanças de ferramentas, mudanças de configuração e bibliotecas.
- **feat:** São adições de novas funcionalidades ou de quaisquer outras novas implantações ao código.
- **fix:** Essencialmente definem o tratamento de correções de bugs.
- **refactor:** Utilizado em quaisquer mudanças que sejam executados no código, porém não alterem a funcionalidade final da tarefa impactada.
- **docs:** Inclusão ou alteração somente de arquivos de documentação.
- **perf:** Uma alteração de código que melhora o desempenho.
- **style:** Alterações referentes a arquivos de estilo como SCSS ou CSS.
- **build:** Alterações que afetam o sistema de construção ou dependências externas (escopos de exemplo: gulp, broccoli, npm).
- **ci:** Mudanças em nossos arquivos e scripts de configuração de CI (exemplo de escopos: Travis, Circle, BrowserStack, SauceLabs).
- **env:** Utilizado na descrição de modificações ou adições em arquivos de configuração em processos e métodos de integração contínua (CI), como parâmetros em arquivos de configuração de containers.
### Exemplos de Commits:
- chore: add commitlint and husky
- chore(eslint): require semicolon
- refactor: typed variables
- feat: add axios / search and check data
- feat(page/home): created route for home page
- fix: NH-3 button color in login
## Branchs
> Prerencialmente feitos em inglês.
- _bugfix/_: Responsável por corrigir bugs pequenos em ambiente de desenvolvimento.
- _feature/_: O nome já diz, uma nova feature que será adicionada ao projeto, componente e afins.
- _hotfix/_: Responsável por corrigir algum erro critico que impeça o cliente de executar alguma função em ambiente de produção.
- _improvement/_: Em si é uma melhoria para uma feature já existente, seja de performance, de escrita, de layout, etc.
### Exemplos de Branchs:
- _bugfix/login-submit-form_: Correção de bug ao submeter o formulário de login
- _feature/login-page-form_: Adição de formulário na página de login
- _hotfix/login-page-submit-button_: Correção de bug no botão de submeter o formulário de login já em produção
- _improvement/login-page-section_: Melhoria na seção de login
## Estrutura dos diretórios
Gere um arquivo de texto com a estrutura de diretórios
```bash
npm run tree
```