{"id":29182623,"url":"https://github.com/andsam321/kpopuniverse","last_synced_at":"2025-07-01T20:07:02.895Z","repository":{"id":300631564,"uuid":"1003138000","full_name":"AndSam321/KPopUniverse","owner":"AndSam321","description":"KPopUniverse is a full-stack web application developed using Angular and Django by Andrew Samountry and Kevin Phitsanu. Designed for passionate K-Pop fans, the platform provides a space to explore, connect, and share their interests through interactive features and community engagement.","archived":false,"fork":false,"pushed_at":"2025-06-30T00:17:02.000Z","size":417,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-30T01:19:49.021Z","etag":null,"topics":["angular","aws","django","postgres"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AndSam321.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-16T17:22:52.000Z","updated_at":"2025-06-30T00:17:06.000Z","dependencies_parsed_at":"2025-06-22T20:27:35.514Z","dependency_job_id":"10770b7b-daed-4f69-935b-11d1d159ae4a","html_url":"https://github.com/AndSam321/KPopUniverse","commit_stats":null,"previous_names":["andsam321/kpopuniverse"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AndSam321/KPopUniverse","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndSam321%2FKPopUniverse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndSam321%2FKPopUniverse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndSam321%2FKPopUniverse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndSam321%2FKPopUniverse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AndSam321","download_url":"https://codeload.github.com/AndSam321/KPopUniverse/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AndSam321%2FKPopUniverse/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263029212,"owners_count":23402354,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular","aws","django","postgres"],"created_at":"2025-07-01T20:07:01.333Z","updated_at":"2025-07-01T20:07:02.874Z","avatar_url":"https://github.com/AndSam321.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎵 Kpop Universe\n\nA vibrant community platform for K-pop fans worldwide! Kpop Universe combines the best of social platforms like Reddit with a sleek, modern UX tailored specifically for fandom culture.\n\n## 🌟 Features\n\n- **User Authentication \u0026 Profiles** - Personalized fan profiles with favorite artists and groups\n- **Post Creation** - Share text, images, links, and media content\n- **Rooms** - Join community groups for specific fandoms, artists, or K-pop events\n- **Interactive Discussions** - Comment and engage in threaded conversations\n- **Content Moderation** - Community-driven moderation tools\n- **Real-time Notifications** - Stay updated on post activity and room updates\n- **Mobile-Friendly** - Optimized for both desktop and mobile experiences\n\n## 🏗️ Tech Stack\n\n### Backend\n- **Django** - Python web framework\n- **Django REST Framework** - API development\n- **PostgreSQL** - Primary database\n- **AWS S3** - Media storage (planned)\n\n### Frontend\n- **Angular** - TypeScript-based frontend framework\n- **Angular Material** - UI component library\n- **Tailwind CSS** - Utility-first CSS framework\n- **SCSS** - Enhanced CSS with variables and mixins\n\n### Infrastructure\n- **AWS** - Cloud deployment and services\n- **Docker** - Containerization (planned)\n\n## 🚀 Getting Started\n\n### Prerequisites\n- Python 3.8+\n- Node.js 16+\n- PostgreSQL 12+\n- Git\n\n### Backend Setup (Django)\n\n1. **Clone the repository**\n   ```bash\n   git clone \u003crepository-url\u003e\n   cd kpop-universe\n   ```\n\n2. **Set up Python environment**\n   ```bash\n   cd backend\n   python -m venv venv\n   \n   # On Windows:\n   venv\\Scripts\\activate\n   # On Mac/Linux:\n   source venv/bin/activate\n   ```\n\n3. **Install dependencies**\n   ```bash\n   pip install -r requirements.txt\n   ```\n\n4. **Environment configuration**\n   ```bash\n   cp .env.example .env\n   # Edit .env with your database credentials and secret key\n   ```\n\n5. **Database setup**\n   ```bash\n   python manage.py migrate\n   python manage.py createsuperuser\n   ```\n\n6. **Run the development server**\n   ```bash\n   python manage.py runserver\n   ```\n\n   The API will be available at `http://localhost:8000/`\n\n### Frontend Setup (Angular)\n\n1. **Navigate to frontend directory**\n   ```bash\n   cd frontend/kpop-universe-frontend\n   ```\n\n2. **Install dependencies**\n   ```bash\n   npm install\n   ```\n\n3. **Run the development server**\n   ```bash\n   ng serve\n   ```\n\n   The application will be available at `http://localhost:4200/`\n\n## 📁 Project Structure\n\n```\nkpop-universe/\n├── backend/                 # Django REST API\n│   ├── kpop_universe_backend/\n│   ├── accounts/           # User authentication\n│   ├── posts/              # Post management\n│   ├── rooms/              # Community rooms\n│   ├── notifications/      # Notification system\n│   ├── requirements.txt\n│   └── manage.py\n├── frontend/               # Angular application\n│   └── kpop-universe-frontend/\n│       ├── src/\n│       ├── angular.json\n│       └── package.json\n├── .gitignore\n├── README.md\n└── CONTRIBUTING.md\n```\n\n## 🛠️ Development\n\n### API Endpoints\n- **Authentication**: `/api/auth/`\n- **Posts**: `/api/posts/`\n- **Rooms**: `/api/rooms/`\n- **Users**: `/api/users/`\n- **Notifications**: `/api/notifications/`\n\n### Key Commands\n\n**Backend:**\n```bash\n# Create new Django app\npython manage.py startapp app_name\n\n# Make migrations\npython manage.py makemigrations\n\n# Apply migrations\npython manage.py migrate\n\n# Create superuser\npython manage.py createsuperuser\n\n# Run tests\npython manage.py test\n```\n\n**Frontend:**\n```bash\n# Generate new component\nng generate component component-name\n\n# Generate new service\nng generate service service-name\n\n# Build for production\nng build --prod\n\n# Run tests\nng test\n```\n\n## 🎨 Design Principles\n\n- **Fan-First**: Every feature designed with K-pop fans in mind\n- **Performance**: Fast loading times for media-heavy content\n- **Mobile Responsive**: Seamless experience across all devices\n- **Engaging UI**: Vibrant, modern design that feels alive\n- **Community Focused**: Tools that foster discussion and connection\n\n## 🤝 Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### Branch Naming Convention\n- `feature/backend-[feature-name]` - Backend features\n- `feature/frontend-[feature-name]` - Frontend features\n- `fix/[issue-description]` - Bug fixes\n- `docs/[update-description]` - Documentation updates\n\n### Commit Message Format\n- `backend: [description]` - Backend changes\n- `frontend: [description]` - Frontend changes\n- `docs: [description]` - Documentation\n- `config: [description]` - Configuration files\n\n## 📋 Roadmap\n\n- [ ] User authentication system\n- [ ] Basic post creation and viewing\n- [ ] Room creation and management\n- [ ] Comment system\n- [ ] Notification system\n- [ ] Real-time chat features\n- [ ] Media upload and optimization\n- [ ] Content moderation tools\n- [ ] Mobile app (future)\n\n## 🔧 Environment Variables\n\nCreate a `.env` file in the backend directory:\n\n```env\nSECRET_KEY=your-secret-key-here\nDEBUG=True\nDB_NAME=kpop_universe_db\nDB_USER=postgres\nDB_PASSWORD=your-db-password\nDB_HOST=localhost\nDB_PORT=5432\n```\n\n## 📱 Screenshots\n\n*Coming soon - screenshots will be added as features are developed*\n\n## 🐛 Known Issues\n\n- None currently - project is in initial development phase\n\n## 📞 Support\n\nIf you encounter any issues or have questions:\n1. Check the [Issues](../../issues) section\n2. Create a new issue with detailed information\n3. Contact the development team\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- Inspired by the vibrant K-pop community\n- Built with love for fans, by fans\n- Special thanks to all contributors\n\n---\n\n**Made with 💜 for the K-pop community**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandsam321%2Fkpopuniverse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fandsam321%2Fkpopuniverse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fandsam321%2Fkpopuniverse/lists"}