https://github.com/haquanq-frontendmentor/age-calculator-app
Solution for frontendmentor.io challenge: age-calculator-app
https://github.com/haquanq-frontendmentor/age-calculator-app
accessibility bem-css frontendmentor-junior html postcss
Last synced: 4 months ago
JSON representation
Solution for frontendmentor.io challenge: age-calculator-app
- Host: GitHub
- URL: https://github.com/haquanq-frontendmentor/age-calculator-app
- Owner: haquanq-frontendmentor
- License: mit
- Created: 2024-05-28T11:39:36.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2025-11-02T09:39:46.000Z (9 months ago)
- Last Synced: 2025-11-02T11:39:40.043Z (9 months ago)
- Topics: accessibility, bem-css, frontendmentor-junior, html, postcss
- Language: CSS
- Homepage: https://haquanq-frontendmentor.github.io/age-calculator-app/
- Size: 799 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Frontend Mentor - Age Calculator App Solution
This is a solution to the [Age calculator app challenge on Frontend Mentor](https://www.frontendmentor.io/challenges/age-calculator-app-dF9DFFpj-Q).
Frontend Mentor challenges help you improve your coding skills by building realistic projects.
## 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 an age in years, months, and days after submitting a valid date through the form
- Receive validation errors if:
- Any field is empty when the form is submitted
- The day number is not between 1-31
- The month number is not between 1-12
- The year is in the future
- The date is invalid e.g. 31/04/1991 (there are 30 days in April)
- View the optimal layout for the interface depending on their device's screen size
- See hover and focus states for all interactive elements on the page
- **Bonus**: See the age numbers animate to their final number when the form is submitted
### Status
Features
- [x] Accessible form controls with validations
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 LTS recommended)
- pnpm (latest version)
### Setup
```
git clone https://github.com/haquanq-frontendmentor/age-calculator-app.git
cd age-calculator-app
pnpm install
```
### Start Development Server
```
pnpm dev
```
## :maple_leaf: Deployment
Deployed to Github Pages via Github Action.