{"id":28761496,"url":"https://github.com/sazardev/english-project","last_synced_at":"2025-06-17T07:06:30.375Z","repository":{"id":298346915,"uuid":"999675950","full_name":"sazardev/english-project","owner":"sazardev","description":"The English Project is a collaborative, community-driven platform designed to help English learners improve their language skills through high-quality, free resources. Built with modern web technologies and powered by community contributions.","archived":false,"fork":false,"pushed_at":"2025-06-10T16:12:49.000Z","size":121,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-06-10T17:34:18.286Z","etag":null,"topics":["astro","contributions-welcome","english-grammar","english-learning","learning","open-source"],"latest_commit_sha":null,"homepage":"","language":"Astro","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/sazardev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-10T16:02:23.000Z","updated_at":"2025-06-10T16:16:46.000Z","dependencies_parsed_at":"2025-06-10T17:42:52.005Z","dependency_job_id":"a68aa996-2ccc-4272-8714-f0f06285aa0e","html_url":"https://github.com/sazardev/english-project","commit_stats":null,"previous_names":["sazardev/english-project"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sazardev/english-project","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sazardev%2Fenglish-project","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sazardev%2Fenglish-project/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sazardev%2Fenglish-project/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sazardev%2Fenglish-project/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sazardev","download_url":"https://codeload.github.com/sazardev/english-project/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sazardev%2Fenglish-project/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260310620,"owners_count":22989841,"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":["astro","contributions-welcome","english-grammar","english-learning","learning","open-source"],"created_at":"2025-06-17T07:06:29.362Z","updated_at":"2025-06-17T07:06:30.360Z","avatar_url":"https://github.com/sazardev.png","language":"Astro","funding_links":[],"categories":[],"sub_categories":[],"readme":"# English Project 📚\n\n**Open Source English Learning Platform**\n\nThe English Project is a collaborative, community-driven platform designed to help English learners improve their language skills through high-quality, free resources. Built with modern web technologies and powered by community contributions.\n\n![English Project](https://img.shields.io/badge/English-Learning-blue) ![Open Source](https://img.shields.io/badge/Open-Source-green) ![Astro](https://img.shields.io/badge/Built%20with-Astro-orange)\n\n## 🌟 Features\n\n- **📊 Structured Learning**: Content organized by skill level (Beginner, Intermediate, Advanced)\n- **🏷️ Categorized Content**: Grammar, Vocabulary, Speaking, Listening, Writing, Reading, Pronunciation, Culture\n- **📱 Mobile-First Design**: Responsive design that works on all devices\n- **🤝 Community-Driven**: Anyone can contribute new lessons and improvements\n- **⚡ Lightning Fast**: Built with Astro for optimal performance\n- **🌐 SEO Optimized**: Proper meta tags and semantic HTML for better discoverability\n- **♿ Accessible**: WCAG compliant for inclusive learning\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Node.js 18+\n- npm or yarn\n- Git\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/sazardev/english-project.git\n\n# Navigate to the project directory\ncd english-project\n\n# Install dependencies\nnpm install\n\n# Start the development server\nnpm run dev\n```\n\nVisit `http://localhost:4321` to see the website in action!\n\n## 🏗️ Project Structure\n\n```\n/\n├── public/                 # Static assets\n│   └── favicon.svg\n├── src/\n│   ├── components/         # Reusable Astro components\n│   │   ├── BlogCard.astro\n│   │   ├── Header.astro\n│   │   └── Footer.astro\n│   ├── content/            # Content collections\n│   │   ├── config.ts       # Content schema definitions\n│   │   └── blog/           # Blog posts (MDX files)\n│   ├── layouts/            # Page layouts\n│   │   ├── BaseLayout.astro\n│   │   ├── MainLayout.astro\n│   │   └── BlogLayout.astro\n│   └── pages/              # File-based routing\n│       ├── index.astro     # Homepage\n│       ├── about.astro     # About page\n│       ├── categories.astro\n│       ├── levels.astro\n│       ├── contribute.astro\n│       └── blog/\n│           ├── index.astro     # Blog listing\n│           └── [slug].astro    # Dynamic blog post pages\n├── astro.config.mjs        # Astro configuration\n└── package.json\n```\n\n## 📝 Contributing\n\nWe welcome contributions from everyone! Here's how you can help:\n\n### Types of Contributions\n\n1. **📚 Content Creation**: Write new lessons, exercises, and learning materials\n2. **🔍 Content Review**: Review and improve existing content\n3. **🐛 Bug Reports**: Report issues or errors you find\n4. **💡 Feature Requests**: Suggest new features or improvements\n5. **🎨 Design**: Improve the user interface and experience\n6. **🌍 Translation**: Help make content accessible in multiple languages\n\n### Creating Content\n\n#### Lesson Structure\n\nAll lessons should be written in MDX format with the following frontmatter:\n\n```markdown\n---\ntitle: \"Your Lesson Title\"\ndescription: \"Brief description of what learners will gain\"\ncategory: \"grammar\" | \"vocabulary\" | \"speaking\" | \"listening\" | \"writing\" | \"reading\" | \"pronunciation\" | \"culture\"\nlevel: \"beginner\" | \"intermediate\" | \"advanced\"\ntags: [\"tag1\", \"tag2\", \"tag3\"]\nauthor: \"Your Name\"\nreadingTime: 10\nfeatured: false\npublishDate: 2024-06-10\n---\n\n# Your Lesson Title\n\nContent goes here...\n```\n\n#### Content Guidelines\n\n- **Clear Structure**: Use headings, subheadings, and bullet points\n- **Practical Examples**: Include real-world usage examples\n- **Interactive Elements**: Add exercises and practice activities\n- **Cultural Context**: Explain cultural nuances when relevant\n- **Progressive Difficulty**: Start simple and build complexity\n\n#### Special Components\n\nUse these custom components to enhance your lessons:\n\n```markdown\n\u003cdiv class=\"example-box\"\u003e\nExample content here\n\u003c/div\u003e\n\n\u003cdiv class=\"tip-box\"\u003e\n💡 **Pro Tip:** Your helpful tip here\n\u003c/div\u003e\n\n\u003cdiv class=\"vocabulary-box\"\u003e\n**Word:** Definition and usage\n\u003c/div\u003e\n\n\u003cdiv class=\"exercise-box\"\u003e\nPractice exercise content\n\u003c/div\u003e\n```\n\n### Submission Process\n\n1. **Fork** the repository\n2. **Create** a new branch for your contribution\n3. **Add** your content following our guidelines\n4. **Test** your changes locally\n5. **Submit** a pull request with a clear description\n\n## 🎯 Content Categories\n\n### Grammar\n\n- Tenses and verb forms\n- Sentence structure\n- Parts of speech\n- Punctuation rules\n\n### Vocabulary\n\n- Themed word lists\n- Synonyms and antonyms\n- Collocations\n- Academic/Business vocabulary\n\n### Speaking\n\n- Pronunciation guides\n- Conversation skills\n- Public speaking\n- Accent training\n\n### Listening\n\n- Comprehension exercises\n- Listening strategies\n- Audio materials\n- Accent recognition\n\n### Writing\n\n- Essay structure\n- Creative writing\n- Business communication\n- Academic writing\n\n### Reading\n\n- Comprehension strategies\n- Speed reading\n- Critical analysis\n- Literature appreciation\n\n### Pronunciation\n\n- Phonetic symbols\n- Word stress\n- Intonation patterns\n- Connected speech\n\n### Culture\n\n- Idioms and expressions\n- Cultural context\n- Social customs\n- Regional differences\n\n## 🎓 Skill Levels\n\n### Beginner (A1-A2)\n\n- Basic vocabulary (1000-2000 words)\n- Simple present tense\n- Elementary grammar\n- Common phrases\n\n### Intermediate (B1-B2)\n\n- Expanded vocabulary (3000-5000 words)\n- Multiple tenses\n- Complex sentences\n- Professional contexts\n\n### Advanced (C1-C2)\n\n- Sophisticated vocabulary (5000+ words)\n- Complex grammar\n- Idiomatic expressions\n- Cultural nuances\n\n## 🛠️ Tech Stack\n\n- **Framework**: [Astro](https://astro.build) - Modern static site generator\n- **Content**: [MDX](https://mdxjs.com) - Markdown with React components\n- **Styling**: Pure CSS with CSS custom properties\n- **Typography**: Inter font family\n- **Deployment**: Vercel/Netlify ready\n\n## 📊 Performance\n\n- **Lighthouse Score**: 100/100 across all metrics\n- **Core Web Vitals**: Optimized for excellent user experience\n- **Bundle Size**: Minimal JavaScript for maximum speed\n- **SEO**: Fully optimized for search engines\n\n## 🌍 Accessibility\n\n- **WCAG 2.1 AA** compliant\n- **Keyboard navigation** support\n- **Screen reader** friendly\n- **High contrast** color scheme\n- **Scalable text** for better readability\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🤝 Community\n\n- **GitHub Discussions**: For questions and community discussions\n- **Issues**: For bug reports and feature requests\n- **Pull Requests**: For code contributions\n- **Wiki**: For detailed documentation\n\n## 🙏 Acknowledgments\n\n- All contributors who help make English learning accessible\n- The Astro team for creating an amazing framework\n- The open-source community for inspiration and support\n\n## 📞 Contact\n\n- **Email**: sazardev@gmail.com\n- **GitHub**: [@sazardev](https://github.com/sazardev)\n- **Website**: [https://the-english-project.netlify.app](https://the-english-project.netlify.app)\n\n---\n\n**Made with ❤️ by the English Project community**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsazardev%2Fenglish-project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsazardev%2Fenglish-project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsazardev%2Fenglish-project/lists"}