Loukatah (لُقطة - "A thing to be collected") is an Android app that empowers communities to reunite people with their lost belongings through collaborative tracking, discovery, and connection.
- Smart Item Reporting: Post lost/found items with photos, descriptions, and locations.
- Smart Search: Find matches using keyword filters.
- Category System: Organize items by type (electronics, documents, jewelry, etc.).
- Secure Messaging: Attach images to your evaluations.
- Community Map: Visualize donors and requests in your area.
- Jetpack Compose - Modern Android UI toolkit
- Kotlin Coroutines - Asynchronous programming
- ViewModel & LiveData - Lifecycle-aware data management
- Room Database - Local data persistence
- Firebase - Authentication and cloud Datastore (if used)
- Material Design 3 - UI components and theming
- Android Studio Ladybug Feature Drop (2024.2.2)
- Android SDK 33+
- Kotlin 2.0.0
-
Clone the repository
git clone https://github.com/Mahfoudh94/Loukatah.git
-
Open in Android Studio
- Select "Open an Existing Project"
- Choose the cloned directory
-
Build and Run
- Click the
▶️ Run button in Android Studio - Choose a connected device or emulator
- Click the
not yet
You can see the TPs folder for the tasks description.
We welcome contributions! Please follow these guidelines:
- Fork the repository
- Create a feature branch
git checkout -b feature/your-feature-name
- Commit changes
- Follow Conventional Commits format
- Example:
feat: add user registration screen
- Push and create Pull Request
- Ensure code follows Kotlin style guide
- Include test coverage for new features
- Update documentation when applicable
- Use meaningful variable names
- Follow official Kotlin coding conventions
- Keep composables small and focused
- Use ViewModel for business logic
This project is licensed under the MIT License - see the LICENSE file for details.
For questions or suggestions:
Project Maintainer: [Mahfoud Bedadda]
GitHub Issues: Create New Issue