Welcome to StudyLodz, a mobile application designed for every student in Łódź! 🇵🇱 This app aims to be your main source of information and guidance for navigating student life, from academic matters to social activities.
The main goal of the "Study in Łódź" app is to create a central, easily accessible source of information for students in Łódź. Its purpose is to simplify adapting to a new academic and city environment and make everyday student life easier.
The idea for the app came from observing the challenges students face, especially those coming to Łódź from other cities. Information about universities, city life, available discounts, scholarships, or cultural events is often scattered across many sources. The "Study in Łódź" app was created to solve this problem by aggregating all essential information in a single, intuitive mobile platform.
The app is designed for:
- Prospective students: Helps choose the right university and study program in Łódź.
- New students: Serves as a guide and assistant during the first weeks and months in a new city.
- Current students: Provides easy access to information about discounts, events, scholarships, and academic life, helping students make the most of what Łódź has to offer.
- 🏠 Home Screen: Your command center for quick access to all app features.
- 📖 University Guide: A comprehensive guide to universities in Łódź.
- 🏙️ About Łódź: Explore the city, its attractions, and why it’s a great place to study.
- 💰 Scholarships & Student Life: Find information about available scholarships and student life tips.
- 💸 Cost of Living Calculator: Estimate your monthly expenses with our handy calculator.
- 🏷️ Student Discounts: A database of places offering student discounts.
The project uses modern technologies to ensure the best user experience:
- Framework: React Native & Expo
- Language: TypeScript
- Routing: Expo Router
- Navigation: React Navigation
- Animations: React Native Reanimated
- Icons: Lucide React Native & Expo Vector Icons
- Styling: StyleSheet, Expo Linear Gradient
- Linting: ESLint
The project has a clear and scalable folder structure that makes development and maintenance easier:
StudyInLodz/
├── app/ # Main app logic and file-based routing
│ ├── (tabs)/ # Screens available in the bottom navigation
│ │ ├── index.tsx # Home screen
│ │ ├── study.tsx # University guide
│ │ ├── lodz.tsx # About Łódź
│ │ ├── scholarship.tsx # Scholarships & student life
│ │ ├── costs.tsx # Cost calculator
│ │ └── discounts.tsx # Student discounts
│ └── _layout.tsx # Main app layout
├── assets/ # Images, fonts, and other static resources
├── components/ # Reusable UI components
├── constants/ # Constants (themes, university data, etc.)
├── hooks/ # Custom React hooks
└── ... # Configuration files
Follow these steps to run a local copy of the project.
Make sure you have Node.js (LTS version) and npm installed on your computer.
-
Clone the repository (if you haven’t already):
git clone https://github.com/konradxmalinowski/StudiujWLodzi.git cd StudiujWLodzi -
Install all project dependencies:
npm install
After installing dependencies, you can start the app:
npm startThis will open the Expo developer tools in your browser. Then you can run the app on:
- Android emulator or device (requires Android Studio)
- iOS simulator or device (requires Xcode on macOS)
- Web browser
The following scripts are available in the project:
npm start: Starts the Expo development server.npm run android: Runs the app on an Android emulator/device.npm run ios: Runs the app on an iOS simulator/device.npm run web: Runs the app in a web browser.npm run lint: Runs ESLint to find and fix code issues.npm run reset-project: Resets the project state (custom script).