Skip to content

Commit a3469bd

Browse files
eramitguptaeramitgupta
committed
Merge remote-tracking branch 'origin/main'
2 parents b954f03 + cd86d32 commit a3469bd

File tree

5 files changed

+243
-0
lines changed

5 files changed

+243
-0
lines changed

‎.github/ISSUE_TEMPLATE/bug_report.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
name: Bug report
3+
about: Create a report to help us improve
4+
title: ''
5+
labels: ''
6+
assignees: ''
7+
8+
---
9+
10+
**Describe the bug**
11+
A clear and concise description of what the bug is.
12+
13+
**To Reproduce**
14+
Steps to reproduce the behavior:
15+
1. Go to '...'
16+
2. Click on '....'
17+
3. Scroll down to '....'
18+
4. See error
19+
20+
**Expected behavior**
21+
A clear and concise description of what you expected to happen.
22+
23+
**Screenshots**
24+
If applicable, add screenshots to help explain your problem.
25+
26+
**Desktop (please complete the following information):**
27+
- OS: [e.g. iOS]
28+
- Browser [e.g. chrome, safari]
29+
- Version [e.g. 22]
30+
31+
**Smartphone (please complete the following information):**
32+
- Device: [e.g. iPhone6]
33+
- OS: [e.g. iOS8.1]
34+
- Browser [e.g. stock browser, safari]
35+
- Version [e.g. 22]
36+
37+
**Additional context**
38+
Add any other context about the problem here.

‎.github/ISSUE_TEMPLATE/feature_request.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
---
2+
name: Feature request
3+
about: Suggest an idea for this project
4+
title: ''
5+
labels: ''
6+
assignees: ''
7+
8+
---
9+
10+
**Is your feature request related to a problem? Please describe.**
11+
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
12+
13+
**Describe the solution you'd like**
14+
A clear and concise description of what you want to happen.
15+
16+
**Describe alternatives you've considered**
17+
A clear and concise description of any alternative solutions or features you've considered.
18+
19+
**Additional context**
20+
Add any other context or screenshots about the feature request here.

‎CONTRIBUTING.md

Lines changed: 113 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,113 @@
1+
# 🤝 Contributing to LaravelLangSyncInertia
2+
3+
Thank you for considering contributing to **LaravelLangSyncInertia**!
4+
We welcome all kinds of contributions — from bug reports and feature requests to documentation improvements and pull requests.
5+
6+
---
7+
8+
## 📋 Table of Contents
9+
10+
- [Getting Started](#-getting-started)
11+
- [How to Contribute](#-how-to-contribute)
12+
- [Code Style](#-code-style)
13+
- [Pull Request Guidelines](#-pull-request-guidelines)
14+
- [Reporting Issues](#-reporting-issues)
15+
- [Feature Requests](#-feature-requests)
16+
- [Need Help?](#-need-help)
17+
18+
---
19+
20+
## 🔧 Getting Started
21+
22+
1. Fork the repository on GitHub.
23+
2. Clone your fork:
24+
25+
```bash
26+
git clone https://github.com/your-username/laravel-lang-sync-inertia.git
27+
cd laravel-lang-sync-inertia
28+
````
29+
30+
3. Install dependencies:
31+
32+
```bash
33+
composer install
34+
```
35+
36+
4. (Optional) For frontend contributions:
37+
38+
```bash
39+
npm install
40+
npm run dev
41+
```
42+
43+
---
44+
45+
## 🧠 How to Contribute
46+
47+
You can contribute in the following ways:
48+
49+
* 📑 Improve documentation
50+
* 🐛 Report bugs
51+
* ✨ Suggest or implement features
52+
* 🧪 Write unit tests
53+
* 🔍 Review pull requests
54+
55+
---
56+
57+
## 🧹 Code Style
58+
59+
This package follows:
60+
61+
* [PSR-12](https://www.php-fig.org/psr/psr-12/) coding standards (use Laravel Pint or PHP-CS-Fixer)
62+
* Type-safe and readable PHP
63+
* Semantic and clean commit messages
64+
65+
To format your code automatically:
66+
67+
```bash
68+
./vendor/bin/pint
69+
```
70+
71+
---
72+
73+
## ✅ Pull Request Guidelines
74+
75+
* ✅ Create a new branch from `main`
76+
* ✅ Keep your pull requests focused on one change
77+
* ✅ Write descriptive commit messages
78+
* ✅ Add tests for new features or fixes
79+
* ✅ Ensure all tests pass before submitting
80+
81+
---
82+
83+
## 🐞 Reporting Issues
84+
85+
When reporting a bug, please include:
86+
87+
* Laravel version
88+
* Package version
89+
* Steps to reproduce
90+
* Expected vs actual behavior
91+
* Relevant error logs (if any)
92+
93+
---
94+
95+
## 💡 Feature Requests
96+
97+
We welcome ideas! If you have a feature request:
98+
99+
* Please check for similar open issues first
100+
* Clearly explain the use case and benefit
101+
* If possible, suggest an API or usage example
102+
103+
---
104+
105+
## 🆘 Need Help?
106+
107+
If you’re stuck, open an [issue](https://github.com/eramitgupta/laravel-lang-sync-inertia/issues) or start a [discussion](https://github.com/eramitgupta/laravel-lang-sync-inertia/discussions). We'll be happy to help.
108+
109+
---
110+
111+
Thank you again for contributing! 💙
112+
113+
```

‎LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2025 Er Amit Gupta
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

‎SECURITY.md

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# 🔐 Security Policy
2+
3+
## Supported Versions
4+
5+
We actively support the latest **major version** of LaravelLangSyncInertia.
6+
7+
| Version | Supported |
8+
|---------|--------------------|
9+
| 1.x | ✅ Yes |
10+
| 0.x | ❌ No (legacy) |
11+
12+
---
13+
14+
## 📢 Reporting a Vulnerability
15+
16+
If you discover a **security vulnerability**, **please do NOT open an issue or pull request**.
17+
18+
Instead, follow these steps:
19+
20+
1. Email us directly at: [info.eramitgupta@gmail.com](mailto:info.eramitgupta@gmail.com)
21+
2. Include:
22+
- Package version
23+
- Laravel version
24+
- Reproduction steps
25+
- Potential impact
26+
27+
We will:
28+
29+
- Acknowledge receipt within 1–2 business days
30+
- Investigate and verify the issue
31+
- Work on a patch and publish a security release
32+
- Credit you (if desired)
33+
34+
---
35+
36+
## 🔒 Best Practices for Users
37+
38+
To help protect your application:
39+
40+
- Always keep this package up to date.
41+
- Use the latest Laravel LTS version when possible.
42+
- Avoid exposing sensitive files in production.
43+
- Sanitize user input when using dynamic language keys (avoid `{user_input}` in keys).
44+
45+
---
46+
47+
## 🙏 Thanks
48+
49+
We appreciate responsible security disclosures to help protect the Laravel community. ❤️
50+
51+
```

0 commit comments

Comments
 (0)