*** This is work in progress ****
A React Native Clone of the popular ASOS App, this project was done over one weekend for learning purposes and is theremore not being maintained. Feel free to fork and use as you please.
It is platform agnostic although nearly all work done so far has been written and tested on iOS.
React-Native is a powerful tool for creating UI, and therefore i've focussed only on the UI. The business logic including data retrieval is ommitted from this project.
FEATURES
- Dynamic Home Page
- Category Listing
- Product List
- Product Info (limited functionality
- Basket
- Favourites
- Account
LEFT OUT
If you fork this project, feel free to extend the following features.
- API Services
- Basket management
- Recently Viewed Objects
- Account information
- No Tests! I like living dangerously
3rd Party Libraries used
- React Native Router Flux (Highly recommended)
- React Native Vector Icons
Getting Started
-
Clone the app
git clone https://github.com/edwinbosire/ASOS.git
-
run npm in the project root folder
npm install
-
run on simulator
react-native run-ios --simulator "iPhone 5s"
Avoid this by opening the project in xcode and chosing run, this is also a better environment to read & fix build time errors.
If you encounter any problem, refer to the React Native Documentation.
Prerequisites
To run the project, you will need Node, Watchman, React-Native CLI and Xcode or Android SDK depending on your chosen platform, you can install these using Homebrew
brew install node
brew install watchman
Node comes with npm, you can use Yarn if you prefer or any other package manager.
npm install -g react-native-cli
- Android SDK or Xcode
Get Xcode from the Mac App Store
Structure
.
├── tests
├── Android
├── ios
├── node_modules
├── src
├── components <== All the "dumb" ui widgets go here**
├── containers <=== top level views akin to viewcontrollers**
├── img <== should be renamed to assets, might copy videos here
├── services <== dummy data classes, to be expanded in the future
└── store <== Data dump from ASOS API
All the interesting things are within the components and containers group.
The iOS app utilises the AppRouter.js
file for ALL navigation, we implement the tabbar from here and use React Native Router Flux to get shit done. This library saved a tonne of work usually associated with rolling out your own Navigator + Redux setup.
Deployment
TODO:
Contributing
Just fork the repo and do your thing.
Authors
-
ME 😀 -
-
The Internet - Shout out to StackOverflow and the ReactNative documentation.
Shameless Plug
In my past life, I used to write apps for other high street brands including Topshop, Topman, Burton, JackWills (offline), Harrods and others I can't recall. So I've got vast experience in building withing the "app commerce" domain and it's truely unbelievable how quick developing with React-Native is.
So here's the deal, I am available for freelance work (as in after work & weekends kinda work) if you are in need of quick dev work in React-Native, Swift or Objective-C let's talk 📧
License
This project is licensed under the MIT License - see the LICENSE.md file for details