Skip to content

azhaguvel/react-native-sidemenu

 
 

Repository files navigation

React Native Side Menu Template

A starting point for react native apps with side menu for Android.

  1. Motivation
  2. Get started
  3. Project Structure
  4. License
  5. Considerations

Motivation

When I worked with ionic framework, one of the better cool features in my opinion, was the ionic default templates. If I wanted to set up a new side menu ionic app, my only work was type ionic start myApp sidemenu in a terminal, and voalla. Unfortunately, until the release of this project, I could not find any complete side menu template for react native, because of this, I decide to do my own template. Feel free to collaborate or suggest any changes, I'm sure that many things can be improved.

Get started

This template uses the beauty project react native vector icons that allow us to use font icons collections such as FontAwesome, Ionicons, MaterialIcons and many others. In order to start a brand new project with react native vector icons, you should follow the instalation steps, which is not necessary for this template that already has the library installed. So, to get started with react native side menu template just follow the steps below:

  1. clone this repo or download the zip file and unzip it.
  2. Make sure you have both NodeJS and npm installed.
  3. In a terminal, inside the root directory, type npm install.
  4. Open your emulator or set up a real device in order to work with react native projects.
  5. In a terminal, inside the root directory, type npm start.
  6. After npm start run successfully, in the same local, type react-native run-android.

That's all, now you can change the project according to your needs. If you prefer, you can start a brand new project typing react-native init myApp, install the react native vector icons, and copy all the app folder to your project, as well change the index.android.js file accordingly. You even still need to copy the folder sidemenu/android/app/src/main/res/drawable for your project.

Project Structure

Basically, this is a default React Native project created by the command line react-native init react-native-sidemenu. The core of the template is:

Project Structure

License

This project is licenced under the MIT License.

Any included software are copyright to their respective authors and mostly under MIT or SIL OFL.

Considerations

It's relatively easy to make some changes if you cannot use react native vector icons and use the built in ToolbarAndroid, although, according the author:

Icon.ToolbarAndroid is a composition of the underlying ToolbarAndroid component.

As soon as possible I intend to create a new branch to do a version with the built in ToolbarAndroid component, or I encourage you to fork this repo and start this work, as well I encourage you to collaborate with any improve for this project.
Hope this template can help you in some way.

Thank you

About

A template for react native apps with sidemenu.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Java 95.8%
  • JavaScript 3.4%
  • Other 0.8%