🌏 FluentDev

FluentDev is a learning platform that bridges blockchain education with real-world English communication. It is designed for global developers, professionals, and learners who want to build a strong foundation in Web3 concepts while improving their ability to explain, discuss, and apply these ideas in clear, confident English.

✨ Learning Paths

Web3 Foundations – For learners who want to understand blockchain, smart contracts, and decentralized technologies in accessible English.

English for Web3 Professionals – For developers and professionals who want to strengthen their technical English and confidently communicate with global teams.

Each chapter combines technical learning with targeted language development through guided lessons, vocabulary, real-world examples, and comprehension practice.

---

🤝 How to Contribute

Contributions are welcome! Follow the steps below to get started:

---

📝 1. Submit an Issue

• Open a new issue to suggest a change or report a bug.
• Want to work on it? Leave a comment asking to be assigned. ⚠️ Please DO NOT create a pull request before being assigned.
• This helps avoid duplicate work and keeps everything organized.

---

🍴 2. Fork the Repository

Click the Fork button at the top of this page and clone your fork:

git clone [email protected]:[your-username]/fluentDev.git 
cd fluentDev

If you've already forked it, sync your local copy:

git remote add upstream https://github.com/SupaMega24/fluentDev
git checkout dev
git fetch upstream
git merge upstream/dev

---

🛠️ 3. Set Up Your Environment

Install dependencies:

npm install

⚠️ Note: Some dependencies aren't yet compatible with React 19. Use the following command instead:

npm install --legacy-peer-deps

---

🌱 4. Create a Feature Branch

git checkout -b your-feature-name

Then start the local dev server:

npm run dev

Open http://localhost:3000 in your browser to view your changes live.

---

💾 5. Commit and Push

Use clear, meaningful commit messages. Reference the issue like so:

git commit -m "Add: new UI component [Fixes #123]"
git push origin your-feature-name

---

🚀 6. Open a Pull Request

• Submit your pull request to the dev branch (not main)

• In the PR description:

  • Reference the issue (e.g., Fixes #123)
  • Explain your changes clearly
  • Add screenshots or demo URLs for visual changes

✅ A Vercel preview deployment will be generated automatically.

---

🔍 7. Code Review

• The maintainers will review your PR
• Please respond to feedback and make any requested changes
• Once approved, your changes will be merged into dev

---

Let me know if you’d like a similar contributor badge section or GitHub templates for issues/PRs!