Skip to content

Latest commit

 

History

History
152 lines (102 loc) · 2.95 KB

File metadata and controls

152 lines (102 loc) · 2.95 KB

🛠️ Contribution Guidelines for FinalCast-OpenSource

Thank you for your interest in contributing to FinalCast-OpenSource! 💜
We’re excited to have you join us in making FinalCast better — whether by improving code, reporting bugs, adding documentation, or suggesting features.

FinalCast is an open-source full-stack podcasting and video conversation platform built on the MERN stack, WebRTC, and FFmpeg. It follows an automated Record → Render → Release workflow for creators.

Please read these guidelines carefully before contributing.


📘 Table of Contents


🙌 How Can I Contribute?

You can contribute in many ways:

  • 🐞 Reporting bugs or crashes
  • ✨ Suggesting new features or improvements
  • 🧠 Adding backend or frontend features
  • 📝 Improving documentation or comments
  • 🔧 Refactoring or optimizing existing code

Contributions from beginners are highly encouraged.


🚀 Getting Started

1️⃣ Fork the Repository

Click the Fork button at the top right of this repository.

2️⃣ Clone Your Fork

git clone https://github.com/<your-username>/FinalCast-OpenSource.git
cd FinalCast-OpenSource

3️⃣ Install Dependencies

Backend

cd backend
npm install

Frontend

cd ../frontend
npm install

4️⃣ Create a New Branch

git checkout -b feature/your-feature-name

🧱 Project Structure

FinalCast-OpenSource/
│
├── backend/
├── frontend/
├── docs/
├── README.md
└── LICENSE

🐛 Reporting Issues

Before opening a new issue:

  • Search existing issues
  • Provide reproducible steps
  • Attach logs/screenshots if needed

🔀 Pull Request Process

  • Branch from main
  • Keep PRs small and focused
  • Reference related issues
  • Be open to review feedback

🧹 Code Style Guidelines

  • Do not over-engineer
  • Keep logic simple and readable
  • Follow existing patterns
  • Add minimal comments only when needed

📝 Commit Message Convention

feat: add new feature
fix: resolve bug
docs: update documentation
refactor: simplify code

🤝 Communication & Conduct

Be respectful and inclusive.
Harassment or toxic behavior will not be tolerated.


🌲 Branching Strategy

  • master → stable
  • feature/* → new features
  • fix/* → bug fixes

📄 License

By contributing, you agree that your contributions fall under the project license.


❤️ Thank You

Happy contributing! 🚀