Sougna is an Android marketplace where users can buy, sell, and connect. List products with images, discover unique items, and engage through ratings and comments in a trusted community environment.
- Product Listings: Upload items with titles, descriptions, and multiple images.
- Search & Filters: Find products by category, price range, or location.
- Ratings & Reviews: Rate sellers and leave detailed feedback.
- Interactive Comments: Discuss products with buyers/sellers.
- Favorites System: Save items for later viewing.
- Notifications: Get alerts for new messages, offers, and reviews.
- 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/drLacheheb/Sougna.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: [Ahmed Yacine Lacheheb]
GitHub Issues: Create New Issue