Skip to main content

RIS Gran Chimú Mobile App

Build and maintain the official mobile health information system for Red Integrada de Salud Gran Chimú. Access institutional news, health facilities, services, and regulatory documents in real-time.

Get StartedExplore Architecture
React Native + Expo
Cross-platform mobile
JWT Authentication
Role-based access control
Offline Mode
Session persistence

Quick Start

Get the RIS Gran Chimú mobile app running on your development environment in minutes.

1

Clone and install dependencies

Clone the repository and install all required packages:
git clone https://github.com/adfv126/ris-gran-chimu-frontend.git
cd ris-gran-chimu-frontend
npm install
2

Configure the API endpoint

Verify the backend API URL in src/services/apiClient.ts:
const BASE_URL = 'https://ris-gran-chimu-backend.vercel.app/api';
The app points to the production backend by default. Update BASE_URL if you’re running a local backend instance.
3

Start the development server

Launch Expo and scan the QR code with Expo Go on your device:
npx expo start
You can also run on specific platforms:
# Android
npm run android

# iOS
npm run ios

# Web
npm run web

Explore by topic

Learn about the core features and architecture of the RIS Gran Chimú mobile app.

Architecture overview

Understand the app structure, routing system, and authentication flow

Public pages

Explore institutional news, health facilities, and regulatory documents

Admin dashboard

Manage content with role-based access control for admins and editors

API integration

Learn how the app communicates with the backend using Axios

Key features

The RIS Gran Chimú mobile app provides comprehensive health information access for citizens and administrators.

Institutional news carousel

Dynamic news feed with the latest updates from Red Integrada de Salud Gran Chimú

Health guide

Comprehensive information about health establishments, services, and strategies

Regulatory documents

Public access to official resolutions and regulatory documentation

Admin panel

Secure content management with role-based permissions for admins and editors

API Reference

Explore the hooks, services, and components that power the RIS Gran Chimú mobile app.

useAuth

Authentication hook with sign in/out and session management

apiClient

Axios instance with JWT token interceptors

ThemedText

Theme-aware text component

useDebounce

Debounce hook for search inputs

PermissionContext

Role-based permission context

ThemedView

Theme-aware view component

Ready to start building?

Follow our quickstart guide to set up your development environment and start contributing to the RIS Gran Chimú mobile app.

Get Started Now

Build docs developers (and LLMs) love

Get started for freeTalk to us