From a8058e451a6a4f99b27c2a738dec3f6a9c82d362 Mon Sep 17 00:00:00 2001 From: Jastria Rahmat Date: Sat, 21 Dec 2024 17:39:14 +0700 Subject: [PATCH] feat: update readme.md --- README.md | 68 ++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 67 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index a0f3641..428d641 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,69 @@ # O-Ring Finder -Straight to the point o-ring size finder tool. visit [this link](https://ijash.github.io/o-ring-finder/) to start using. +## Table of Contents + +- [O-Ring Finder](#o-ring-finder) + - [Table of Contents](#table-of-contents) + - [Introduction](#introduction) + - [Using the Site](#using-the-site) + - [Setup and Development](#setup-and-development) + - [Prerequisites](#prerequisites) + - [Setup](#setup) + - [Code Overview](#code-overview) + - [Build and Deploy](#build-and-deploy) + - [Contributing](#contributing) + - [License](#license) + +## Introduction + +O-Ring Finder is a web tool to help users find the right o-ring size and details. It is built with React and TypeScript, hosted on GitHub Pages. + +## Using the Site + +1. Visit: [O-Ring Finder](https://ijash.github.io/o-ring-finder/) +2. Use the input form to filter o-rings. +3. Click on any row to view detailed o-ring specifications. + +## Setup and Development + +### Prerequisites + +- Node.js v14+ +- npm v6+ +- TypeScript v4+ +- React v18+ + +### Setup + +1. Clone: `git clone https://github.com/ijash/o-ring-finder.git` +2. Install dependencies: `npm install` +3. Start development server: `npm start` or `npm run dev` + +### Code Overview + +- `public`: Static assets and index.html. +- `src`: Application source code. + - `src/components`: React components for the UI: + - **Header**: App title and description. + - **InputSection**: Form for filtering o-rings. + - **TableSection**: Displays filtered o-rings. + - **Modal**: Shows o-ring details. + - **Footer**: Footer content. + - `src/data`: Raw o-ring data and utilities. + - `src/css`: CSS/SCSS styles. + +### Build and Deploy + +1. Build: `npm run build` +2. Deploy: `npm run deploy` + +## Contributing + +1. Create a branch: `git checkout -b my-feature` +2. Make changes and commit: `git commit -m "Add feature"` +3. Push: `git push origin my-feature` +4. Open a pull request. + +## License + +O-Ring Finder is under the [GNU GPLv3](LICENSE).