An open API service indexing awesome lists of open source software.

https://github.com/othastudio/react-native-luminus

A powerful template for your next React Native project, designed with a focus on developer experience ! 🚀
https://github.com/othastudio/react-native-luminus

Last synced: 7 months ago
JSON representation

A powerful template for your next React Native project, designed with a focus on developer experience ! 🚀

Awesome Lists containing this project

README

          


React Native Luminus


React Native - Expo Template for large-scale projects

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![React Native](https://img.shields.io/badge/react--native-0.64-blue.svg)](https://reactnative.dev)
[![Expo](https://img.shields.io/badge/expo-43.0.0-blue.svg)](https://expo.io)
[![Typescript](https://img.shields.io/badge/typescript-4.3.5-blue.svg)](https://www.typescriptlang.org)
[![Expo Router](https://img.shields.io/badge/expo--router-2.0.0-blue.svg)](https://github.com/expo/expo/tree/master/packages/react-navigation)
[![Axios](https://img.shields.io/badge/axios-0.21.1-blue.svg)](https://github.com/axios/axios)

## Introduction

Welcome to our powerful template for React Native projects, specifically designed for large-scale applications. This template focuses on providing an exceptional developer experience and optimizing performance. By incorporating cutting-edge technologies such as Typescript, Expo, Expo Router, and Axios, we've created a streamlined development process that will supercharge your next project.

## Features

- **Typescript**: Utilize the benefits of static typing and enhanced tooling with the Typescript language.
- **Expo**: Leverage the power of Expo, a set of tools and services for developing, building, and deploying universal apps.
- **Expo Router**: Seamlessly navigate between screens with Expo Router, a routing library specifically designed for Expo projects.
- **Axios**: Simplify your HTTP requests with Axios, a promise-based HTTP client for making API calls effortlessly.

## Prerequisites

Before you get started, ensure that you have the following prerequisites installed on your machine:

- Node.js (version 12 or above)
- Yarn or npm package manager
- Expo CLI (globally installed)
- Git (optional, but recommended)

## Getting Started

Follow these steps to set up the project on your local machine:

1. Clone the repository: `git clone https://github.com/your-username/your-project.git`.
2. Change into the project's directory: `cd your-project`.
3. Install the dependencies: `yarn install` or `npm install`.
4. Start the development server: `expo start`.

## Project Structure

The template follows a well-organized structure to keep your codebase clean and maintainable. Here's an overview of the project structure:

```
your-project/
├── src/
│ ├── components/
│ ├── screens/
│ ├── navigation/
│ ├── services/
│ ├── utils/
│ ├── themes/
│ └── App.tsx
├── .expo/
├── .gitignore
├── package.json
└── README.md
```

- **src**: Contains all the source code files.
- **components**: Houses reusable components that can be shared across different screens.
- **screens**: Includes individual screen components for different sections of your application.
- **navigation**: Contains navigation-related code and configuration.
- **services**: Provides services for making API calls and handling data.
- **utils**: Contains utility functions and helpers.
- **themes**: Houses theme-related files and styles.
- **App.tsx**: The entry point of your application.

Feel free to adapt the structure to fit the needs of your project.

## Contributing

We welcome contributions from the community. To contribute to this project, please follow these steps:

1. Fork the repository.
2. Create a new branch: `git checkout -b my-feature`.
3. Make your changes and commit them: `git commit -am 'Add some feature'`.
4. Push the changes to your branch: `git push origin my-feature`.
5. Submit a pull request.

Please ensure that your pull request adheres to our coding guidelines and passes all tests.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

## Acknowledgments

We would like to express our gratitude to the developers and contributors of the technologies used in this project. Their hard work and dedication are greatly appreciated.

---

We hope this template serves as a solid foundation for your next React Native project. Happy coding! 🚀