{"id":28578452,"url":"https://github.com/powerappsdarren/my-payload-app","last_synced_at":"2025-06-11T01:10:23.853Z","repository":{"id":296622024,"uuid":"993982873","full_name":"PowerAppsDarren/my-payload-app","owner":"PowerAppsDarren","description":null,"archived":false,"fork":false,"pushed_at":"2025-06-01T00:31:11.000Z","size":67,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-01T10:20:40.389Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","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/PowerAppsDarren.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-05-31T23:49:52.000Z","updated_at":"2025-06-01T00:31:14.000Z","dependencies_parsed_at":"2025-06-01T10:21:26.365Z","dependency_job_id":"00a8e431-3343-4a09-8b33-8beb66e2e81b","html_url":"https://github.com/PowerAppsDarren/my-payload-app","commit_stats":null,"previous_names":["powerappsdarren/my-payload-app"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerAppsDarren%2Fmy-payload-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerAppsDarren%2Fmy-payload-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerAppsDarren%2Fmy-payload-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerAppsDarren%2Fmy-payload-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PowerAppsDarren","download_url":"https://codeload.github.com/PowerAppsDarren/my-payload-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PowerAppsDarren%2Fmy-payload-app/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259178542,"owners_count":22817389,"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":[],"created_at":"2025-06-11T01:10:13.882Z","updated_at":"2025-06-11T01:10:23.816Z","avatar_url":"https://github.com/PowerAppsDarren.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 My Payload App\n\n[![Payload CMS](https://img.shields.io/badge/Payload%20CMS-3.40.0-blue?style=flat-square)](https://payloadcms.com)\n[![Next.js](https://img.shields.io/badge/Next.js-15.3.3-black?style=flat-square)](https://nextjs.org)\n[![Docker](https://img.shields.io/badge/Docker-Ready-2496ED?style=flat-square\u0026logo=docker\u0026logoColor=white)](https://docker.com)\n[![MongoDB](https://img.shields.io/badge/MongoDB-7.0-47A248?style=flat-square\u0026logo=mongodb\u0026logoColor=white)](https://mongodb.com)\n\n\u003e 🎯 A modern, headless CMS built with Payload, Next.js, and Docker. Perfect for content management that doesn't get in your way!\n\n## ✨ Features\n\n- 🎨 **Modern Admin Interface** - Beautiful, intuitive content management\n- 🔐 **Authentication Ready** - User management out of the box\n- 📝 **Rich Text Editor** - Powered by Lexical for amazing content creation\n- 🐳 **Docker Compose** - One-command development environment\n- 🗄️ **MongoDB** - Flexible, scalable database with admin interface\n- 🔒 **Secure by Default** - Environment variables and proper authentication\n- ⚡ **TypeScript** - Full type safety throughout\n- 🎯 **API First** - REST and GraphQL endpoints ready to go\n\n## 🏗️ Tech Stack\n\n| Technology | Purpose | Version |\n|------------|---------|---------|\n| 🎯 [Payload CMS](https://payloadcms.com) | Headless CMS | 3.40.0 |\n| ⚡ [Next.js](https://nextjs.org) | React Framework | 15.3.3 |\n| 🐳 [Docker](https://docker.com) | Containerization | Latest |\n| 🍃 [MongoDB](https://mongodb.com) | Database | 7.0 |\n| 📘 [TypeScript](https://typescriptlang.org) | Type Safety | 5.6.3 |\n| ⚛️ [React](https://reactjs.org) | UI Library | 19.0.0 |\n\n## 🚀 Quick Start\n\n### Prerequisites\n- 🐳 Docker \u0026 Docker Compose\n- 📦 Node.js 18+ (for local development)\n\n### 🎬 Get Started in 3 Steps\n\n```bash\n# 1️⃣ Clone and navigate\ngit clone \u003cyour-repo-url\u003e\ncd my-payload-app\n\n# 2️⃣ Fire up the engines! 🚀\nnpm run docker:up\n\n# 3️⃣ Open your browser and enjoy! 🎉\n# http://localhost:3000\n```\n\nThat's it! 🎊 Your CMS is ready to rock!\n\n## 🌐 Available Services\n\n| Service | URL | Description |\n|---------|-----|-------------|\n| 🎯 **Main App** | http://localhost:3000 | Your beautiful frontend |\n| 👤 **Admin Panel** | http://localhost:3000/admin | Content management magic |\n| 🗄️ **Database Admin** | http://localhost:8081 | MongoDB management |\n| 🔌 **API Endpoint** | http://localhost:3000/api | REST \u0026 GraphQL APIs |\n\n## 🔧 Development Commands\n\n```bash\n# 🚀 Start everything (recommended)\nnpm run docker:up\n\n# 🏗️ Rebuild and start\nnpm run docker:up:build\n\n# 🛑 Stop all services\nnpm run docker:down\n\n# 📋 View logs\nnpm run docker:logs\n\n# 🔄 Generate types (when config changes)\nnpm run generate:types\n\n# 🧹 Lint your code\nnpm run lint\n```\n\n## 📁 Project Structure\n\n```\nmy-payload-app/\n├── 🎯 payload.config.ts          # Payload configuration\n├── 🔧 next.config.mjs            # Next.js setup\n├── 🐳 docker-compose.yml         # Docker services\n├── 📦 package.json               # Dependencies \u0026 scripts\n├── 🔒 .env                       # Environment variables\n├── 📝 payload-types.ts           # Generated types\n└── 📂 src/\n    └── 📂 app/\n        ├── 🏠 layout.tsx          # Root layout\n        ├── 📄 page.tsx            # Home page\n        ├── 🔌 api/                # API routes\n        └── 👤 (payload)/          # Admin interface\n```\n\n## 🎨 Collections\n\n### 👥 Users\n- 🔐 Authentication enabled\n- 📧 Email-based login\n- 🛡️ Role-based permissions\n\n### 📄 Pages\n- 📝 Rich text content with Lexical editor\n- 🏷️ Title and content fields\n- 🎯 Perfect for websites and blogs\n\n## 🔒 Environment Variables\n\nCreate your `.env` file (check `.env.example` for reference):\n\n```bash\n# 🗄️ Database\nDATABASE_URI=mongodb://mongodb:27017/payload-app\n\n# 🔐 Security\nPAYLOAD_SECRET=your-super-secret-key\n\n# 🌐 App\nNEXT_PUBLIC_SERVER_URL=http://localhost:3000\n```\n\n## 🐳 Docker Services\n\n| Service | Purpose | Port |\n|---------|---------|------|\n| 🎯 **app** | Next.js + Payload | 3000 |\n| 🍃 **mongodb** | Database | 27017 |\n| 🖥️ **mongo-express** | DB Admin UI | 8081 |\n\n## 🔧 Customization\n\n### Adding New Collections\n\n1. 📝 Edit `payload.config.ts`\n2. 🔄 Run `npm run generate:types`\n3. 🚀 Restart with `npm run docker:up:build`\n\n### Custom Fields \u0026 Components\n\nCheck out the [Payload documentation](https://payloadcms.com/docs) for:\n- 🎨 Custom field types\n- 🧩 Custom components\n- 🎣 Hooks and lifecycle events\n- 🔌 Plugin development\n\n## 🚨 Troubleshooting\n\n### 🐛 Common Issues\n\n**Admin panel shows config error?**\n```bash\n# Try rebuilding\nnpm run docker:down\nnpm run docker:up:build\n```\n\n**Database connection issues?**\n```bash\n# Check if MongoDB is running\ndocker ps\n# Restart services\nnpm run docker:down \u0026\u0026 npm run docker:up\n```\n\n**Port conflicts?**\n- 🎯 App: Change port 3000 in docker-compose.yml\n- 🍃 MongoDB: Change port 27017\n- 🖥️ Mongo Express: Change port 8081\n\n## 🔄 Staying Updated\n\n### 📦 Check for Updates\n```bash\n# See available updates\nnpm outdated\n\n# Check specific Payload packages\nnpm outdated payload @payloadcms/next @payloadcms/db-mongodb\n```\n\n### 🚀 Update Payload\n```bash\n# Update all Payload packages\nnpm update payload @payloadcms/next @payloadcms/db-mongodb @payloadcms/richtext-lexical\n\n# Update to latest stable\nnpm install payload@latest\n\n# After updates, always regenerate types!\nnpm run generate:types\nnpm run docker:up:build\n```\n\n### 🔔 Stay Informed\n- ⭐ [Star Payload on GitHub](https://github.com/payloadcms/payload) for release notifications\n- 📖 Follow the [Payload Blog](https://payloadcms.com/blog) for major updates\n- 💬 Join [Discord Community](https://discord.com/invite/payload) for discussions\n- 🐦 Follow [@payloadcms](https://twitter.com/payloadcms) on Twitter\n\n### ⚠️ Update Best Practices\n```bash\n# 1. Create update branch\ngit checkout -b update-payload\n\n# 2. Update and test\nnpm update payload\nnpm run docker:up:build\n\n# 3. Test admin panel \u0026 API endpoints\n\n# 4. If all good, merge\ngit checkout main \u0026\u0026 git merge update-payload\n```\n\n\u003e 💡 **Pro Tip**: Always read release notes for breaking changes before major updates!\n\n## 🤝 Contributing\n\n1. 🍴 Fork the repo\n2. 🌟 Create your feature branch\n3. ✨ Make your changes\n4. 🧪 Test everything works\n5. 🚀 Submit a pull request\n\n## 📚 Resources\n\n- 📖 [Payload CMS Docs](https://payloadcms.com/docs)\n- ⚡ [Next.js Documentation](https://nextjs.org/docs)\n- 🐳 [Docker Documentation](https://docs.docker.com)\n- 🍃 [MongoDB Documentation](https://docs.mongodb.com)\n\n## 📄 License\n\nMIT License - feel free to use this for your awesome projects! 🎉\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Made with ❤️ and lots of ☕**\n\n*Happy coding! 🚀*\n\n\u003c/div\u003e","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpowerappsdarren%2Fmy-payload-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpowerappsdarren%2Fmy-payload-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpowerappsdarren%2Fmy-payload-app/lists"}