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

https://github.com/haquanq-frontendmentor/advice-generator-app

Solution for frontendmentor.io challenge: advice-generator-app
https://github.com/haquanq-frontendmentor/advice-generator-app

adviceslip-api bem-css frontendmentor html postcss typescript vite

Last synced: about 2 months ago
JSON representation

Solution for frontendmentor.io challenge: advice-generator-app

Awesome Lists containing this project

README

          

## Frontend Mentor - Advice Generator App Solution

This is a solution to the [Advice generator app challenge on Frontend Mentor](https://www.frontendmentor.io/challenges/advice-generator-app-QdUG-13db). Frontend Mentor challenges help you improve your coding skills by building realistic projects.



Solution post


Live demo


![](./docs/preview.jpg)

## Table of Contents

- [Project Overview](#sunrise-project-overview)
- [Tech Stack and Approach](#stars-tech-stack-and-approach)
- [Local Development](#leaves-local-development)
- [Deployment](#maple_leaf-deployment)

## :sunrise: Project Overview

### Challenge Requirements

- View the optimal layout for the app depending on their device's screen size
- See hover states for all interactive elements on the page
- Generate a new piece of advice by clicking the dice icon

### Status

Features

- [x] Get random piece of advice

Accessibility

- [x] Responsive accross different screen sizes
- [x] Interactive elements have clear focus indicator

## :stars: Tech Stack and Approach

### Built With

- **HTML5** – Semantic structure
- **CSS Grid & Flexbox** – Layout
- **PostCSS** – Nested rules, custom media queries, future CSS features, minification
- **Stylelint** – CSS linting, code style consistency
- **TypeScript** - Interactivity and application logic
- **Vite** - Fast development server, production build and easy configuration

### Approach

- Mobile-first workflow for better performance on smaller devices
- Accessibility guided by [ARIA Authoring Practices Guide (APG)](https://www.w3.org/WAI/ARIA/apg/)

## :leaves: Local Development

### Prerequisites

Install the following:

- Git (latest version)
- Node.js (latest version)

### Setup

```
git clone https://github.com/haquanq-frontendmentor/advice-generator-app.git
cd advice-generator-app
pnpm install
```

### Start Development Server

```
pnpm dev
```

## :maple_leaf: Deployment

Deployed to Github Pages via Github Action.