Awesome
Lyrics King <img src="_github/lk-logo.gif" width="80">
A React Native native app utilising Expo, React Navigation and fetching data from multiple API's (Deezer and Lyrics.OVH). UI built with Adobe XD. <br><br> Built as a personal training project for React Native. Designed in Adobe XD. Design and development by Stephen Kempin. This project was bootstrapped with Create React Native App.
Expo Demo Link
<img src="https://github.com/SKempin/Lyrics-King-React-Native/blob/master/_github/header-overview.jpg" width="900" alt="Lyrics King - React Native Expo app">Contents
- App Preview
- Expo Project Page
- Adobe XD files
- App Features
- Getting Started
- What's Included
- API's Used
- Contributing
- Author
- Google Play Store
- Donate
- License
App Preview
Video Preview
<a href="https://expo.io/@skempin/lyrics-king"> <img src="https://github.com/SKempin/Lyrics-King-React-Native/blob/master/_github/screenshots/video.gif" width="350" > </a>Search Screen
<img src="https://github.com/SKempin/Lyrics-King-React-Native/blob/master/_github/screenshots/search.jpg" width="270" alt="Lyrics King - Search screen" hspace="5"><img src="https://github.com/SKempin/Lyrics-King-React-Native/blob/master/_github/screenshots/suggestions.jpg" width="270" alt="Lyrics King - Suggestions on search screen">
Details Screen
<img src="https://github.com/SKempin/Lyrics-King-React-Native/blob/master/_github/screenshots/details-ariana.jpg" width="270" hspace="5" alt="Lyrics King - Details screen, Ariana Grande"><img src="https://github.com/SKempin/Lyrics-King-React-Native/blob/master/_github/screenshots/details-above.jpg" width="270" hspace="5" alt="Lyrics King - Details screen, Above and Beyond"><img src="https://github.com/SKempin/Lyrics-King-React-Native/blob/master/_github/screenshots/details-dua.jpg" width="270" alt="Lyrics King - Details screen, Dua Lipa">
About Screen
<img src="https://github.com/SKempin/Lyrics-King-React-Native/blob/master/_github/screenshots/about.jpg" width="270" alt="Lyrics King - About screen">Navigation (Drawer)
<img src="https://github.com/SKempin/Lyrics-King-React-Native/blob/master/_github/screenshots/navigation.jpg" width="270" alt="Lyrics King - Navigation drawer">Expo Project Page
This project has been built using Expo. Please install npm install expo-cli --global to run this project locally.
Scan the below QR code to open the project on Android:
Adobe XD files
Design files for the UI can be found in _design_assets/adobeXD in the project root. UI design implemented with flexbox.
App Features
Screens
src/screens/
SearchScreen.js- Search the Deezer API by song title (class component)DetailsScreen.js- Selected song details (including Lyrics.ovh API call) (class component)AboutScreen.js- About details (functional component)
Components
src/components/
Credits.js- Development credentials template (functional component)SocialButton.js- Button template for sharing links/ the app (functional component)Suggestions.js- Song suggestions (functional component)
Config
src/config/
router.js- App navigation routing (including drawer nav render method)colours.js- Colour constants
Lib
src/lib/
constants.js- Expo manifest constants and functions
Utils
src/utils/
shareHelper.js- Native device share method
Getting Started
- Install the latest Node
- Install Expo -
npm install expo-cli --global cdinto this project directorynpm installoryarn install- Run
expo start
What's Included
| Name | Description |
|---|---|
| Expo (incl. React Native) | Expo is a free and open source toolchain built around React Native to help you build native iOS and Android projects using JavaScript and React. |
| React Navigation | Routing and navigation for your React Native apps. |
| Format Duration | Convert a number in milliseconds to a standard duration string. |
| RN-Placeholder | Display some placeholder stuff before rendering your text or media content in React Native. |
API's Used
Contributing
Due to time constraints there are several features that I haven’t been able to develop yet. If you would like to develop your React Native skills and contribute any of the features below this would be hugely beneficial! :tada:
- Debouncing or throttling on search functionality.
- PropTypes on components.
- Adding clear search button functionality on Android. This functionality already exists on iOS.
- Animations would be a nice touch! Fading in the details screen background image would be priority.
- Any general performance improvements.
Other contributions and suggestions are always very welcome! Contact me if you wish to discuss anything.
Author
Google Play Store
View my commercial apps on the SK-UK Google Play Store
<a href='https://play.google.com/store/apps/developer?id=SK+-+UK&pcampaignid=MKT-Other-global-all-co-prtnr-py-PartBadge-Mar2515-1'><img alt='SK-UK Google Play Store' src='https://github.com/SKempin/Lyrics-King-React-Native/blob/master/_github/google-play.jpg' width='180px'></a>
Donate
If you like this project and wish to say to say thanks - I'm always open to a coffee! :coffee:
<a href="https://www.buymeacoffee.com/oru9CZh" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/black_img.png" alt="Buy Me A Coffee" width='180px' ></a>
License
You are welcome to use this however you wish within the MIT license, but please retain my credentials and links back to this repo.