Welcome to Listopia 👋

Listopia is an exercise in building a RESTful web app using React-Redux, and Rails API.

The goal is building a real-world-like project, built with business specifications. In which I had to build an MVP before a given deadline.

Find the code for the server-side API can, and the relevant documentation can at Listopia-Rails-Api

✨ Demo

🔨 Tools

Create-React-App
React / React-Dom / React-Router-Dom
Redux / React-Redux / Redux-thunk / Reselect
Material UI
Axios
Styled Components

🎉 Features

Mobile web app.
Responsive layout.
Shared state managment.
Structured, Semantic HTML.
CRUD operations.
Asynchronous data fetching.
Front-end routing.
Material Design.

🚧 Future development

Proper Authentication/Authorization.
Normalize Redux store.
Optimize data fetching.
Use Helmet for SOE.
Build create/update postings form.
Add support for storing/fetching images.

🚀 Getting Started

This guide shows how to clone, install, start and develop the client-side in your local environment. But, it will fetch data from my remote deployed server. For running your own local server, clone the server-side repository: at Listopia-Rails-Api.

Clone

git clone git@github.com:Nazeh/listopia.git
cd listopia

Install

npm install

Usage

npm run start

Run tests

npm run test

Customize

Change files in the config directory.

Deploy

npm install netlify-cli -g
netlify login
netlify deploy --prod

Author

👤 Ar Nazeh

Twitter: @ArNazeh
Github: @Nazeh
LinkedIn: @arnazeh

Credits

Design credits goes to the creators of Real Estate Classified App concept on Behance.

🤝 Contributing

Contributions, issues and feature requests are welcome!

Show your support

Give a ⭐️ if you like this project!

📝 License

This project is MIT licensed.

Nuhvi/listopia