Skip to content

Commit

Permalink
docs: update project documentation
Browse files Browse the repository at this point in the history
References: #49, #50

Signed-off-by: Prince Muel <[email protected]>
  • Loading branch information
princemuel committed May 8, 2023
1 parent 9ef2d53 commit fb7aeed
Show file tree
Hide file tree
Showing 3 changed files with 27 additions and 21 deletions.
20 changes: 13 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,14 +10,14 @@
- [Screenshot](#screenshot)
- [Project Links](#project-links)
- [My process](#my-process)
- [Building with](#building-with)
- [Built with](#built-with)
- [The challenge (Situation)](#the-challenge-situation)
- [Expected Behaviour (Tasks)](#expected-behaviour-tasks)
- [Author](#author)

## Overview

This project uses the STAR approach.
This project was bootstrapped using Vite and uses the STAR approach.

### Screenshot

Expand All @@ -33,20 +33,26 @@ Press `.` on the keyboard to view this project's code just like in Visual Studio

## My process

### Building with
### Built with

- Semantic HTML5 markup
- CSS custom properties
- Flexbox
- CSS Grid
- Mobile-first workflow
- [React](https://reactjs.org/) - JS library
- [Next.js](https://nextjs.org/) - React framework
- [Tailwind CSS](https://tailwindcss.com/docs) - For component composition and styles
- [Vite](https://vitejs.dev/guide/) - A next-gen frontend build tool for JavaScript that aims to provide a faster and leaner development experience for modern web projects
- [React](https://react.dev/learn) - A Javascript library for web and native user interfaces
- [Next.js](https://nextjs.org/docs) - A React framework for building web applications
- [Typescript](https://www.typescriptlang.org/docs/) - A strongly typed programming language that builds on JavaScript, giving you better tooling at any scale
- [Graphql](https://graphql.org/learn/) - A server-side runtime for executing queries using a type system you define for your data
- [TanStack Query for React](https://tanstack.com/query/latest/docs/react/overview) - A powerful asynchronous state management library for React which makes fetching, caching, synchronizing and updating server state in your web applications a breeze
- [Immer](https://immerjs.github.io/immer/) - A javascript package which helps you interact with your data by simply modifying it while keeping all the benefits of immutable data
- [Tailwind CSS](https://tailwindcss.com/docs/installation) - A utility-first CSS framework packed with classes that can be composed to build any design, directly in your markup
- [Headless UI](https://headlessui.com/) - Completely unstyled, fully accessible UI components, designed to integrate beautifully with Tailwind CSS

### The challenge (Situation)

View the User Stories at the [User Stories Markdown File](./stories.md)
View the User Stories in the [User Stories Markdown File](./docs/stories.md)

### Expected Behaviour (Tasks)

Expand Down
14 changes: 14 additions & 0 deletions docs/stories.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# User Stories for Invoicer

The user should be able to:

1. - [ ] View the optimal layout for the app depending on their device's screen size
2. - [x] See hover states for all interactive elements on the page
3. - [x] Create, read, update, and delete invoices
4. - [x] Receive form validations when trying to create/edit an invoice
5. - [x] Save draft invoices, and mark pending invoices as paid
6. - [x] Get warning, success or error notifications while performing operations on an invoice
7. - [x] Filter invoices by status (draft/pending/paid)
8. - [x] Toggle the application's theme between light/dark modes
9. - [x] Keep track of any changes, even after refreshing the browser
10. - [x] Sign in and out of the application
14 changes: 0 additions & 14 deletions stories.md

This file was deleted.

0 comments on commit fb7aeed

Please sign in to comment.