https://github.com/fahmad480/nounsarlab
Get weird with Nouns! Dive into the quirky world of Nouns with immersive AR right on your phone.
https://github.com/fahmad480/nounsarlab
augmentedreality camerakit flutter nft nouns nounsdao snapchat
Last synced: 6 months ago
JSON representation
Get weird with Nouns! Dive into the quirky world of Nouns with immersive AR right on your phone.
- Host: GitHub
- URL: https://github.com/fahmad480/nounsarlab
- Owner: fahmad480
- License: gpl-3.0
- Created: 2025-04-01T13:19:02.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-04-01T13:57:36.000Z (7 months ago)
- Last Synced: 2025-04-01T14:40:46.745Z (7 months ago)
- Topics: augmentedreality, camerakit, flutter, nft, nouns, nounsdao, snapchat
- Language: Dart
- Homepage: https://apps.apple.com/us/app/nouns-ar-lab/id6737252963
- Size: 3.03 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎭 Nouns AR Lab
Nouns AR Lab is an innovative application that combines the concept of YouTube Shorts with Snapchat's Camera Kit SDK. Experience the future of social media with our portfolio showcase that enables users to interact with videos using cutting-edge AR effects.
## ✨ Features
- 📱 **Seamless Video Scrolling** - Enjoy smooth, TikTok-like vertical scrolling
- ⚡ **Smart Preloading** - Videos buffer in advance for uninterrupted viewing
- 🎭 **AR Lens Gallery** - Explore a variety of augmented reality effects
- 🔍 **Personalized Content** - Tailor your experience with content preferences
- 📸 **Snapchat Camera Integration** - Powered by Snapchat's Camera Kit SDK
- 🔄 **Social Sharing** - Share your favorite AR experiences with friends
- 💾 **Save to Gallery** - Download videos and AR effects to your device
## 📱 App Availability
- **iOS**: Now available on the [App Store](https://apps.apple.com/us/app/nouns-ar-lab/id6737252963)!
- **Android**: Currently in closed testing phase. Stay tuned for the public release!
## 🚀 Installation
To install the Flutter project for development, follow these steps:
1. Make sure you have Flutter SDK installed on your machine. If not, you can download it from the official Flutter website.
2. Clone the project repository using the following command:
```bash
git clone https://github.com/fahmad480/NounsARLab
```
3. Navigate to the project directory:
```bash
cd NounsARLab
```
4. Run the following command to fetch the project dependencies:
```bash
flutter pub get
```
5. For iOS, follow this step first before proceeding to step 7:
```bash
cd ios
pod install
```
6. Open the Xcode workspace inside the `ios` folder.
7. Connect your device or start an emulator.
8. Run the project using the following command:
```bash
flutter run
```
This will start the Flutter project on your device or emulator.
## ⚙️ Platform Setup
### Android Setup
To enable Firebase services for Android, place your `google-services.json` file inside the `android/app/` directory.
### iOS Setup
To enable Firebase services for iOS, place your `GoogleService-Info.plist` file inside the `ios/Runner/` directory.
## 🌐 Enable Localization for CameraKit for iOS
To enable localization for CameraKit, follow these steps:
1. Open the `Localizable.strings` file located at `Pods Project -> Pods -> SCCameraKitReferenceUI -> Resources -> Localizable.strings`.
2. Make sure the `SCCameraKitReferenceUI` target is selected in the "Target Membership" section on the right side of Xcode.
3. Build the project to apply the changes.
## 📚 Additional Configuration for Camera Kit SDK
For additional configuration of Camera Kit SDK, refer to the repository:
[Camera Kit Flutter](https://github.com/DevCrew-io/camerakit-flutter).
## 📝 TODOs
1. 🎨 Improve UI to be more visually appealing, avoiding Flutter stock UI.
2. 👆 Make lens list clickable.
3. 🔄 Backup server content/storage and database.
## 👥 Contributors
- **Imam Solihin** (Project Manager)
- [Instagram](https://www.instagram.com/mmsolihin)
- [LinkedIn](https://www.linkedin.com/in/imam-solihin-9bb04975/)
- **Faraaz Ahmad Permadi** (App Developer)
- [Instagram](https://www.instagram.com/faraaz.id)
- [LinkedIn](https://www.linkedin.com/in/faraazahmadpermadi/)
## 🤝 Contributing
We welcome contributions! Follow these steps to contribute:
1. **Fork the repository** – Click on the "Fork" button at the top-right corner of the repository page.
2. **Clone your fork** – Download your forked repository to your local machine:
```bash
git clone https://github.com/your-username/NounsARLab.git
```
3. **Create a new branch** – Work on your changes in a dedicated branch:
```bash
git checkout -b feature-your-feature-name
```
4. **Make your changes** – Implement your changes and commit them:
```bash
git add .
git commit -m "Added feature: your feature name"
```
5. **Push to GitHub** – Upload your branch:
```bash
git push origin feature-your-feature-name
```
6. **Open a Pull Request** – Go to the repository on GitHub and open a Pull Request describing your changes.
We will review your changes and merge them if they align with the project's direction. Thank you for your contributions! 🎉