Skip to content

obibaadoma/weWaste

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

23 Commits
 
 
 
 
 
 

Repository files navigation

♻️ Redesign Waste Management App

🧠 Overview

This project is a redesign of the "Choose Your Skip Size" page from WeWantWaste.co.uk.
The goal was to provide a cleaner, responsive, and user-friendly UI/UX while preserving and improving existing functionalities.It is focused on clarity, accessibility, and mobile-friendliness.

🔗 Live Preview (CodeSandbox)

👉 Click here to test the redesigned page

✅ Project Requirements


📂 Project Structure

waste-management-app/ ├── .babelrc # Babel configuration ├── .eslintrc.json # ESLint configuration ├── .github/ # GitHub specific files (e.g., workflows) ├── .gitignore # Specifies intentionally untracked files that Git should ignore ├── .stylelintrc.json # Stylelint configuration ├── README.md # This file! ├── node_modules/ # Project dependencies (managed by npm/yarn) ├── package-lock.json # Records exact versions of dependencies ├── package.json # Project metadata and dependencies ├── postcss.config.js # PostCSS configuration (often used with Tailwind CSS) ├── public/ # Static assets (index.html, favicon, etc.) │ ├── index.html │ └── manifest.json ├── src/ # Main application source code │ ├── App.css # Main styles for App component │ ├── App.js # Root React component │ ├── App.test.js # Tests for App component │ ├── Components/ # Reusable UI components │ │ ├── BottomBar.js │ │ ├── ProgressBar.js │ │ ├── SkipCard.js │ │ └── SkipSelector.js │ ├── Pages/ # Page-level components (if any) │ │ └── HomePage.js # Example page │ ├── index.css # Global styles and Tailwind directives │ ├── index.js # Entry point of the React application │ ├── reportWebVitals.js # Performance monitoring │ └── setupTests.js # Jest setup for tests └── tailwind.config.js # Tailwind CSS configuration

│ └── index.css # Tailwind directives ├── tailwind.config.js # Tailwind setup ├── package.json └── README.md


🛠️ Tech Stack

  • React – Use React to build the user interface
  • HTML – Markup language for structuring and presenting content on the web
  • CSS – Cascading Style Sheets for styling web pages
  • JavaScript – Programming language for adding interactivity to web pages
  • Git – Version control system for tracking changes in source code during software development
  • Tailwind CSS – Utility-first CSS framework for styling
  • Vite / Create React App – Fast React build tool (CRA used in this case)

🚀 My Approach

  1. API Integration:

    • Fetched data from the API endpoint
    • Handled loading and error states gracefully
  2. Component-Based Design:

    • SkipCard: Displays a single skip with name, size, price, etc.
    • SkipList: Maps through the skip options and renders them responsively
    • SkipSelector: Handles skip selection and state management
    • BottomBar: Manages the bottom navigation bar
    • ProgressBar: Tracks the user's progress through the app
  3. UI/UX Improvements:

    • Introduced a clean, modern card layout
    • Improved spacing, typography, and accessibility
    • Included mobile-first responsive breakpoints
    • Added smooth transitions and animations
    • Implemented a responsive bottom navigation bar
    • Added a progress bar to track user progress
    • Added a skip selector to allow users to select a skip size
    • Added a skip list to display the available skip options
  4. Responsiveness:

    • Used Tailwind’s responsive utilities (sm:, md:, lg:) to ensure proper layout on all screen sizes

📷 Screenshots

Add screenshots of the new UI on desktop and mobile (optional but nice).


📦 How to Run Locally

# Clone the repo
git clone https://github.com/your-username/waste-management-app.git
cd waste-management-app

# Install dependencies
npm install

# Run the app
npm run dev   # or npm start

---

## 🔧 Getting Started

1. **Clone the repository**

```bash
git clone https://github.com/obibaadoma/weWaste.git
cd weWaste
cd waste-management-app

📈 Future Enhancements
✅ Integrate real skip size API

✅ Add cart and booking functionality

✅ Implement great work across different 

🌍 Add location-based pricing

🔒 User authentication (optional)

🤝 Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

📄 License
MIT

👤 Derek Akrasi Konadu

GitHub: @obibaadoma
LinkedIn: https://www.linkedin.com/in/derek-akrasi-konadu-187453151/

💬 Feedback
If you have any feedback or suggestions, feel free to reach out or open an issue.


## Available Scripts

In the project directory, you can run:

### `npm start`

Runs the app in the development mode.\
Open [http://localhost:3000](http://localhost:3000) to view it in your browser.

The page will reload when you make changes.\
You may also see any lint errors in the console.

### `npm test`

Launches the test runner in the interactive watch mode.\
See the section about [running tests](https://facebook.github.io/create-react-app/docs/running-tests) for more information.

### `npm run build`

Builds the app for production to the `build` folder.\
It correctly bundles React in production mode and optimizes the build for the best performance.

The build is minified and the filenames include the hashes.\
Your app is ready to be deployed!

See the section about [deployment](https://facebook.github.io/create-react-app/docs/deployment) for more information.

### `npm run eject`

**Note: this is a one-way operation. Once you `eject`, you can't go back!**

If you aren't satisfied with the build tool and configuration choices, you can `eject` at any time. This command will remove the single build dependency from your project.

Instead, it will copy all the configuration files and the transitive dependencies (webpack, Babel, ESLint, etc) right into your project so you have full control over them. All of the commands except `eject` will still work, but they will point to the copied scripts so you can tweak them. At this point you're on your own.

You don't have to ever use `eject`. The curated feature set is suitable for small and middle deployments, and you shouldn't feel obligated to use this feature. However we understand that this tool wouldn't be useful if you couldn't customize it when you are ready for it.

About

React project to redesign the front end of a website,

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published