React Native mobile application for the NoteVerse university management system. Built with Expo, React Native Paper, and React Navigation.
- Authentication: Secure login with JWT token storage
- Course Management: View all enrolled courses and current semester courses
- Course Details: Access course information, schedules, and teachers
- Documents: View course documents and materials
- AI Assistant: Chat interface for school-related questions (coming soon)
- Dark Mode Support: Beautiful light and dark themes
- Expo SDK 54: Cross-platform development framework
- React Native: Mobile app framework
- React Native Paper: Material Design component library
- React Navigation: Navigation and routing
- Axios: HTTP client for API requests
- AsyncStorage: Persistent data storage
- Node.js (v14 or higher)
- npm or yarn
- Expo Go app (for testing on physical devices)
- iOS Simulator (macOS only) or Android Emulator
- Install dependencies:
cd note.verse.mobile
npm install- Configure backend URL:
Edit src/api/axios.js and update the API_BASE_URL:
// For iOS simulator
const API_BASE_URL = 'http://localhost:3000/api';
// For Android emulator
const API_BASE_URL = 'http://10.0.2.2:3000/api';
// For physical device (replace with your computer's IP)
const API_BASE_URL = 'http://192.168.1.XXX:3000/api';npm start# iOS Simulator (macOS only)
npm run ios
# Android Emulator
npm run android
# Web browser
npm run web- Install Expo Go on your mobile device
- Scan the QR code from the terminal
- The app will load on your device
note.verse.mobile/
├── src/
│ ├── api/ # API integration
│ │ ├── axios.js # HTTP client setup
│ │ ├── courses.js # Course endpoints
│ │ └── documents.js # Document endpoints
│ ├── contexts/ # React contexts
│ │ └── AuthContext.js # Authentication state
│ ├── navigation/ # Navigation setup
│ │ └── AppNavigator.js # Main navigation
│ ├── pages/ # Screen components
│ │ ├── Login.js # Login screen
│ │ ├── Derslerim.js # Courses list
│ │ ├── CourseDetail.js # Course details
│ │ └── Assistant.js # AI chat
│ ├── theme.js # App theme configuration
├── App.js # Root component
├── app.json # Expo configuration
└── package.json # Dependencies
The app connects to the NoteVerse backend server. Make sure the backend is running before using the app:
POST /api/auth/login- User authenticationGET /api/auth/verify- Token verificationGET /api/students/:id/courses- Student coursesGET /api/students/:id/courses/semester/:semester/:year- Current semester coursesGET /api/course-offerings/:id- Course detailsGET /api/documents- Course documents
# Navigate to backend directory
cd ../note.verse.backend
# Start the backend server
npm run devThe backend should run on http://localhost:3000
Edit src/theme.js to customize colors:
export const lightTheme = {
colors: {
primary: '#00A4B4', // Primary brand color
secondary: '#ec4899', // Secondary color
// ... more colors
},
};Modify timeout in src/api/axios.js:
const api = axios.create({
baseURL: API_BASE_URL,
timeout: 10000, // 10 seconds
});- Email and password authentication
- Secure token storage
- Form validation
- Loading states
- List of all enrolled courses
- Current semester courses highlighted
- Course cards with:
- Course code and name
- Semester and credits
- Teacher information
- Schedule and classroom
- Pull to refresh
- Navigation to course details
- Tabbed interface:
- Genel Bilgiler: Course information
- Dökümanlar: Course documents
- Sohbet: AI chat (coming soon)
- Teacher and schedule details
- Document listing
- Chat interface
- Suggested questions
- Message history
- (SSE integration needed for live chat)
- Check if backend is running on port 3000
- Verify API_BASE_URL in
src/api/axios.js - For Android emulator, use
10.0.2.2instead oflocalhost - For physical devices, use your computer's local IP address
- Verify backend
/api/auth/loginendpoint works - Check network connection
- Ensure credentials are correct
- Check console for error messages
- Make sure all navigation dependencies are installed
- Clear cache:
npx expo start -c - Reinstall dependencies:
rm -rf node_modules && npm install
- Clear Expo cache:
npx expo start -c - Check for missing dependencies
- Verify App.js syntax
- Check console for error stack trace
- Create screen in
src/pages/:
// src/pages/NewScreen.js
export default function NewScreen() {
return (
<View>
<Text>New Screen</Text>
</View>
);
}- Add to navigation in
src/navigation/AppNavigator.js:
import NewScreen from '../pages/NewScreen';
// In navigator:
<Stack.Screen name="NewScreen" component={NewScreen} />Add function to appropriate file in src/api/:
export const coursesApi = {
// ... existing functions
newEndpoint: async (id) => {
const response = await api.get(`/endpoint/${id}`);
return response.data;
},
};eas build --platform ioseas build --platform androidNote: Requires Expo EAS account. See Expo EAS Build for setup.
- SSE (Server-Sent Events) for chat not yet implemented
- File upload for documents not implemented
- Camera/file picker integration pending
- Push notifications not configured
- Implement SSE for real-time chat
- Add document upload functionality
- Push notifications for announcements
- Offline mode support
- Grade viewing
- Assignment submission
- Calendar view
- Dark mode toggle in settings
MIT
NoteVerse Team
For web version, see ../note.verse.ui