{"id":29428859,"url":"https://github.com/muzaffar640/commitpress","last_synced_at":"2025-07-12T16:01:45.838Z","repository":{"id":297940106,"uuid":"998272634","full_name":"muzaffar640/commitpress","owner":"muzaffar640","description":"This is a full-stack system where you can have a blog feature in your portfolio without needing a proper backend with a database.","archived":false,"fork":false,"pushed_at":"2025-07-01T06:40:41.000Z","size":7080,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-01T07:23:17.752Z","etag":null,"topics":["blog","blogging-platform","freelancer","mdx","nextjs","nextjs-template","open-source","portfolio"],"latest_commit_sha":null,"homepage":"https://commitpress.muzaffarhossain.com","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/muzaffar640.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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-08T08:47:30.000Z","updated_at":"2025-07-01T06:40:44.000Z","dependencies_parsed_at":"2025-07-01T07:33:31.556Z","dependency_job_id":null,"html_url":"https://github.com/muzaffar640/commitpress","commit_stats":null,"previous_names":["muzaffar640/db-free-blog-portfolio","muzaffar640/commitpress"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/muzaffar640/commitpress","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muzaffar640%2Fcommitpress","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muzaffar640%2Fcommitpress/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muzaffar640%2Fcommitpress/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muzaffar640%2Fcommitpress/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/muzaffar640","download_url":"https://codeload.github.com/muzaffar640/commitpress/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/muzaffar640%2Fcommitpress/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265016750,"owners_count":23698364,"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":["blog","blogging-platform","freelancer","mdx","nextjs","nextjs-template","open-source","portfolio"],"created_at":"2025-07-12T16:00:39.110Z","updated_at":"2025-07-12T16:01:45.819Z","avatar_url":"https://github.com/muzaffar640.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 CommitPress\n\n\u003e **The complete portfolio + blog system.** Beautiful portfolio UI with database-free blogging. Perfect for developers, designers, writers, and any professional. **Now with AI-powered formatting.**\n\n**[🔗 View on GitHub](https://github.com/muzaffar640/commitpress)** • **[📖 Live Demo](https://commitpress.vercel.app)** • **[🚀 Deploy Now](https://vercel.com/new/clone?repository-url=https://github.com/muzaffar640/commitpress)**\n\n[![Next.js](https://img.shields.io/badge/Next.js-15-black?logo=next.js)](https://nextjs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5-blue?logo=typescript)](https://www.typescriptlang.org/)\n[![Tailwind CSS](https://img.shields.io/badge/Tailwind_CSS-3-38B2AC?logo=tailwind-css)](https://tailwindcss.com/)\n[![MDX](https://img.shields.io/badge/MDX-3-1C1E24?logo=mdx)](https://mdxjs.com/)\n[![AI-Powered](https://img.shields.io/badge/AI-Powered-brightgreen?logo=cursor)](https://cursor.sh/)\n\n\n\nhttps://github.com/user-attachments/assets/969c4d33-aaf5-4f12-993a-dbfe72e4fb4b\n\n\n## 🎯 What You Get\n\n**Complete Professional Portfolio + Blog System:**\n\n- 🎨 **Stunning Portfolio UI** - Hero, About, Experience, Skills sections\n- 📝 **Database-Free Blog** - Write in Markdown, publish with Git\n- 🤖 **AI-Powered Content** - Automatic formatting with Cursor\n- 📱 **Fully Responsive** - Perfect on all devices\n- ⚡ **Lightning Fast** - Static generation for optimal performance\n- 🔍 **SEO Optimized** - Built-in meta tags and social sharing\n\n## 👥 Perfect For\n\n- **Software Engineers** - Showcase projects and share technical knowledge\n- **Designers** - Display portfolio work and design insights\n- **Writers \u0026 Content Creators** - Professional presence with easy blogging\n- **Consultants \u0026 Freelancers** - Establish credibility and thought leadership\n- **Students \u0026 Job Seekers** - Stand out with a professional online presence\n- **Any Professional** - Clean, modern portfolio with integrated blogging\n\n## 🤔 The Problem\n\nTraditional solutions are **unnecessarily complex**:\n\n- 🗄️ Database setup and management\n- 🔐 Admin panels and authentication\n- 💰 Database hosting costs\n- 🐛 Complex deployment pipelines\n- 📝 Separate portfolio and blog systems\n- 🎨 Limited design customization\n\n## ✨ The Solution\n\n**What if your portfolio + blog could work like your code?**\n\n1. ✍️ Write your content in Markdown (`.mdx`)\n2. 📝 Commit to git\n3. 🚀 Push to deploy\n4. ✅ **That's it!**\n\n## 🎯 Why This Approach Wins\n\n| Traditional Setup      | CommitPress     |\n| ---------------------- | --------------- |\n| Portfolio + Blog + CMS | Single Solution |\n| Database + Admin Panel | Just Git        |\n| Complex deployment     | Simple push     |\n| Hosting costs          | Static hosting  |\n| Data backups           | Git history     |\n| Limited customization  | Full control    |\n\n## 🚀 Quick Start\n\n### 1. Clone \u0026 Install\n\n```bash\ngit clone https://github.com/muzaffar640/commitpress.git\ncd commitpress\nnpm install\n```\n\n### 2. Run Development Server\n\n```bash\nnpm run dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) to see your portfolio + blog.\n\n### 3. Customize Your Portfolio\n\nUpdate the portfolio sections in the components:\n\n- **Hero Section**: `src/components/Hero.tsx` - Your name, title, and intro\n- **About Section**: `src/components/About.tsx` - Your story and background\n- **Experience**: `src/components/ExperienceAndSkills.tsx` - Work history and skills\n- **Contact**: Update social links and contact information\n\n### 4. Write Your First Blog Post\n\nCreate a new file in `src/app/content/my-first-post.mdx`:\n\n```mdx\n---\ntitle: \"My First CommitPress Post\"\ndate: \"2024-01-15\"\nauthor: \"Your Name\"\ncoverImage: \"/images/my-cover.jpg\"\ntags: [\"CommitPress\", \"portfolio\", \"professional\"]\nexcerpt: \"This is how easy it is to publish without a database!\"\n---\n\n# Hello World!\n\nThis post lives in a `.mdx` file. When I commit and push this file,\nit automatically becomes a live blog post. No database required!\n\n## What I Love About CommitPress:\n\n- ✅ Beautiful portfolio design\n- ✅ Integrated blog functionality\n- ✅ Syntax highlighting for code\n- ✅ SEO optimization\n- ✅ Professional appearance\n- ✅ Easy to maintain\n```\n\n### 5. Publish Your Content\n\n```bash\ngit add .\ngit commit -m \"Add: Updated portfolio and first blog post\"\ngit push origin main\n```\n\n**🎉 Your portfolio + blog is now live!**\n\n## 🤖 AI-Powered Writing with Cursor\n\nThis project includes **Cursor AI rules** that automatically format content into proper MDX structure.\n\n### Writing with AI Assistance\n\n1. **Open Cursor** with this project\n2. **Create a new `.mdx` file** in `src/app/content/`\n3. **Paste your raw content** (from any source)\n4. **Ask Cursor AI** to format it as a blog post\n5. **Commit and publish**\n\n### What the AI Rules Do\n\n- ✅ **Auto-format** raw text into proper MDX structure\n- ✅ **Generate frontmatter** with proper metadata\n- ✅ **Add syntax highlighting** for code blocks\n- ✅ **Structure headings** with semantic hierarchy\n- ✅ **Optimize for SEO** and accessibility\n- ✅ **Maintain consistency** across all posts\n\n### Content Migration Made Easy\n\nGot content from Medium, LinkedIn articles, or anywhere else? Just paste it:\n\n```bash\n# 1. Create new post file\ntouch src/app/content/my-migrated-post.mdx\n\n# 2. Open in Cursor and paste your content\n# 3. Ask AI to format it as a blog post\n# 4. Commit and publish\ngit add . \u0026\u0026 git commit -m \"Add: Migrated post\" \u0026\u0026 git push\n```\n\n### AI Workflow Comparison\n\n**Traditional:**\n\n- Use separate portfolio builder\n- Set up blog with database\n- Manually format content\n- Manage multiple platforms\n\n**AI-Powered CommitPress:**\n\n- One beautiful system for everything\n- Paste raw content anywhere\n- AI formats everything automatically\n- Single Git workflow\n\n## 📁 Project Structure\n\n```\nsrc/\n├── app/\n│   ├── content/          # 📝 Your blog posts (MDX files)\n│   │   ├── my-post.mdx\n│   │   └── another-post.mdx\n│   ├── blog/\n│   │   ├── page.tsx      # 📋 Blog listing page\n│   │   └── [slug]/       # 📄 Individual post pages\n│   └── globals.css\n├── components/           # 🧩 Reusable components\n│   ├── Hero.tsx         # 🌟 Hero section\n│   ├── About.tsx        # 👤 About section\n│   ├── ExperienceAndSkills.tsx  # 💼 Experience \u0026 skills\n│   ├── Blog/            # 📝 Blog components\n│   └── ui/              # 🎨 UI components\n├── utils/\n│   └── mdx.ts           # 🔧 MDX processing logic\n├── types/               # 📘 TypeScript definitions\n└── .cursor/rules/       # 🤖 AI formatting rules\n```\n\n## 🎨 Features\n\n### Portfolio Features\n\n- **🌟 Professional Hero Section** - Eye-catching introduction\n- **👤 About Section** - Tell your story professionally\n- **💼 Experience Timeline** - Showcase your work history\n- **🛠️ Skills Display** - Highlight your expertise\n- **📱 Responsive Design** - Perfect on all devices\n- **🎨 Modern UI** - Built with Tailwind CSS + Shadcn/ui\n\n### Blog Features\n\n- **🎯 Zero Database** - Content stored as MDX files\n- **🤖 AI-Powered Formatting** - Automatic content formatting\n- **📝 MDX Support** - Markdown + React components\n- **🏷️ Tag System** - Organize posts with tags\n- **📊 Reading Time** - Auto-calculated estimates\n- **🎨 Syntax Highlighting** - Beautiful code blocks\n\n### Technical Features\n\n- **⚡ Static Generation** - Blazing fast, SEO-friendly\n- **🔍 SEO Optimized** - Meta tags, OpenGraph, structured data\n- **⚙️ TypeScript** - Full type safety\n- **🚀 Easy Deployment** - Deploy anywhere static hosting works\n\n## 🚀 Deployment\n\n### Deploy to Vercel (Recommended) for FREE\n\n1. Push your code to GitHub\n2. Connect your repo to [Vercel](https://vercel.com)\n3. Deploy with zero configuration\n\n### Deploy to Any Static Host\n\n```bash\nnpm run build\nnpm run export\n# Upload the 'out' folder to your host\n```\n\n## 🛠️ Customization\n\n### Portfolio Customization\n\n**Update Your Information:**\n\n- Edit `src/components/Hero.tsx` for name, title, and bio\n- Modify `src/components/About.tsx` for your story\n- Update `src/components/ExperienceAndSkills.tsx` for work history\n- Change social links in `src/components/Footer.tsx`\n\n**Styling:**\n\n- Edit `src/app/globals.css` for global styles\n- Modify `tailwind.config.ts` for theme customization\n- All components use Tailwind CSS + Shadcn/ui\n\n### Adding Blog Components\n\nEdit `src/components/MDX/MDXComponents.tsx` to add custom components:\n\n```tsx\nexport const MDXComponents = {\n  // Custom components available in all MDX files\n  YouTubeEmbed: ({ videoId }: { videoId: string }) =\u003e (\n    \u003ciframe\n      src={`https://youtube.com/embed/${videoId}`}\n      className=\"w-full aspect-video rounded-lg\"\n    /\u003e\n  ),\n  // ... other components\n};\n```\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🌟 Show Your Support\n\nIf this project helped you, please give it a ⭐ and share it with others!\n\n## 🤔 FAQ\n\n**Q: Is this just for developers?**\nA: No! It's perfect for any professional - designers, writers, consultants, freelancers, students, or anyone who needs a professional online presence.\n\n**Q: How do I customize the portfolio sections?**\nA: Edit the component files in `src/components/` - Hero.tsx, About.tsx, ExperienceAndSkills.tsx, etc.\n\n**Q: How do the AI rules work?**\nA: Install [Cursor](https://cursor.sh/), open the project, paste any content, and ask AI to \"format this as a blog post.\"\n\n**Q: Can I migrate content from other platforms?**\nA: Yes! Copy content from Medium, LinkedIn, Dev.to, WordPress, or Google Docs. The AI will format it properly.\n\n**Q: How do I handle images?**\nA: Store images in the `public`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuzaffar640%2Fcommitpress","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuzaffar640%2Fcommitpress","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuzaffar640%2Fcommitpress/lists"}