├── flags
├── svg
│ ├── CI.svg
│ ├── BD.svg
│ ├── NG.svg
│ ├── GB-ENG.svg
│ ├── DE.svg
│ ├── GA.svg
│ ├── BE.svg
│ ├── BL.svg
│ ├── FR.svg
│ ├── GN.svg
│ ├── IE.svg
│ ├── IT.svg
│ ├── LV.svg
│ ├── MF.svg
│ ├── ML.svg
│ ├── NC.svg
│ ├── RE.svg
│ ├── RO.svg
│ ├── TD.svg
│ ├── TH.svg
│ ├── WF.svg
│ ├── MG.svg
│ ├── BH.svg
│ ├── QA.svg
│ ├── BS.svg
│ ├── BJ.svg
│ ├── CG.svg
│ ├── PS.svg
│ ├── SD.svg
│ ├── LC.svg
│ ├── SO.svg
│ ├── GM.svg
│ ├── DZ.svg
│ ├── LA.svg
│ ├── GY.svg
│ ├── AE.svg
│ ├── GF.svg
│ ├── GH.svg
│ ├── GW.svg
│ ├── SN.svg
│ ├── CL.svg
│ ├── CM.svg
│ ├── MM.svg
│ ├── SR.svg
│ ├── JM.svg
│ ├── VC.svg
│ ├── CR.svg
│ ├── BQ-SA.svg
│ ├── ID.svg
│ ├── MC.svg
│ ├── PL.svg
│ ├── UA.svg
│ ├── KP.svg
│ ├── AT.svg
│ ├── AX.svg
│ ├── BV.svg
│ ├── FO.svg
│ ├── IS.svg
│ ├── NO.svg
│ ├── SJ.svg
│ ├── TG.svg
│ ├── CH.svg
│ ├── DK.svg
│ ├── PK.svg
│ ├── SE.svg
│ ├── SY.svg
│ ├── CF.svg
│ ├── JP.svg
│ ├── PW.svg
│ ├── FI.svg
│ ├── GB-SCT.svg
│ ├── ST.svg
│ ├── AM.svg
│ ├── BG.svg
│ ├── EE.svg
│ ├── HU.svg
│ ├── LT.svg
│ ├── LU.svg
│ ├── NL.svg
│ ├── RU.svg
│ ├── SL.svg
│ ├── YE.svg
│ ├── CO.svg
│ ├── NR.svg
│ ├── TL.svg
│ ├── BB.svg
│ ├── TO.svg
│ ├── EH.svg
│ ├── BW.svg
│ ├── CZ.svg
│ ├── GR.svg
│ ├── MU.svg
│ ├── TT.svg
│ ├── NE.svg
│ ├── KW.svg
│ ├── BF.svg
│ ├── MA.svg
│ ├── CA.svg
│ ├── AW.svg
│ ├── LR.svg
│ ├── VN.svg
│ ├── IL.svg
│ ├── CN.svg
│ ├── LY.svg
│ ├── TZ.svg
│ ├── AG.svg
│ ├── GG.svg
│ ├── SS.svg
│ ├── CW.svg
│ ├── PA.svg
│ ├── KN.svg
│ ├── SC.svg
│ ├── MK.svg
│ ├── TN.svg
│ ├── CD.svg
│ ├── MR.svg
│ ├── TR.svg
│ ├── TW.svg
│ ├── FM.svg
│ ├── BA.svg
│ ├── GL.svg
│ ├── HN.svg
│ ├── NP.svg
│ ├── AZ.svg
│ ├── GE.svg
│ ├── MV.svg
│ ├── ET.svg
│ ├── DJ.svg
│ ├── CU.svg
│ ├── PR.svg
│ ├── AQ.svg
│ ├── MY.svg
│ ├── WS.svg
│ ├── JO.svg
│ ├── TK.svg
│ ├── SV.svg
│ ├── LB.svg
│ ├── NA.svg
│ ├── MH.svg
│ ├── SG.svg
│ ├── IN.svg
│ ├── KM.svg
│ ├── ZA.svg
│ ├── IQ.svg
│ ├── SB.svg
│ ├── LS.svg
│ ├── BQ-SE.svg
│ ├── CX.svg
│ ├── BI.svg
│ ├── PY.svg
│ ├── MW.svg
│ ├── VE.svg
│ ├── KE.svg
│ ├── MN.svg
│ ├── MT.svg
│ ├── KR.svg
│ ├── UZ.svg
│ ├── GI.svg
│ ├── CC.svg
│ ├── TF.svg
│ ├── OM.svg
│ ├── MZ.svg
│ ├── PG.svg
│ ├── GD.svg
│ ├── GB-NIR.svg
│ ├── GB-UKM.svg
│ ├── HK.svg
│ ├── RW.svg
│ ├── NI.svg
│ ├── EG.svg
│ ├── TJ.svg
│ ├── CV.svg
│ ├── SK.svg
│ ├── GQ.svg
│ ├── IM.svg
│ ├── BQ-BO.svg
│ ├── UM.svg
│ ├── US.svg
│ ├── MO.svg
│ ├── UG.svg
│ ├── KG.svg
│ └── AU.svg
└── README.md
├── time-zones
└── README.md
├── scripts
└── validate-flags.js
├── COMMUNITY_STATS.md
├── MIT-License
├── .github
├── ISSUE_TEMPLATE
│ ├── feature-request.yml
│ └── data-correction.yml
└── workflows
│ └── community-stats.yml
├── .gitignore
└── CHANGELOG.md
/flags/svg/CI.svg:
--------------------------------------------------------------------------------
1 |
8 |
--------------------------------------------------------------------------------
/flags/svg/BD.svg:
--------------------------------------------------------------------------------
1 |
10 |
--------------------------------------------------------------------------------
/flags/svg/NG.svg:
--------------------------------------------------------------------------------
1 |
10 |
--------------------------------------------------------------------------------
/flags/svg/GB-ENG.svg:
--------------------------------------------------------------------------------
1 |
10 |
--------------------------------------------------------------------------------
/flags/svg/DE.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/GA.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/BE.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/BL.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/FR.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/GN.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/IE.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/IT.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/LV.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/MF.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/ML.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/NC.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/RE.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/RO.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/TD.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/TH.svg:
--------------------------------------------------------------------------------
1 |
10 |
--------------------------------------------------------------------------------
/flags/svg/WF.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/MG.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/BH.svg:
--------------------------------------------------------------------------------
1 |
10 |
--------------------------------------------------------------------------------
/flags/svg/QA.svg:
--------------------------------------------------------------------------------
1 |
10 |
--------------------------------------------------------------------------------
/flags/svg/BS.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/BJ.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/CG.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/time-zones/README.md:
--------------------------------------------------------------------------------
1 | # Time Zone Imports
2 |
3 | Use the SQL file listed to create a new database table which contains the following.
4 |
5 | 1. Country Code
6 | 2. Country Name
7 | 3. Time Zone
8 | 4. GMT Offset
9 |
10 | ### Notes
11 |
12 | If you are looking for a more comprehensive time zone download, visit this website [ https://timezonedb.com ] here you can download a large database which covers a massive range of time zone information.
13 |
14 | There is also an API available. [ https://timezonedb.com/api ]
15 |
--------------------------------------------------------------------------------
/flags/svg/PS.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/SD.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/LC.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/SO.svg:
--------------------------------------------------------------------------------
1 |
10 |
--------------------------------------------------------------------------------
/flags/svg/GM.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/DZ.svg:
--------------------------------------------------------------------------------
1 |
6 |
--------------------------------------------------------------------------------
/flags/svg/LA.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/GY.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/AE.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/GF.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/GH.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/GW.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/SN.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/CL.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/CM.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/MM.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/SR.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/JM.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/VC.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/CR.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/BQ-SA.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/ID.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/MC.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/PL.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/UA.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/KP.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/AT.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/AX.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/BV.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/FO.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/IS.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/NO.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/SJ.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/TG.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/CH.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/DK.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/PK.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/SE.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/SY.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/CF.svg:
--------------------------------------------------------------------------------
1 |
14 |
--------------------------------------------------------------------------------
/flags/svg/JP.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/PW.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/FI.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/GB-SCT.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/ST.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/AM.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/BG.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/EE.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/HU.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/LT.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/LU.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/NL.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/RU.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/SL.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/YE.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/CO.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/NR.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/scripts/validate-flags.js:
--------------------------------------------------------------------------------
1 | const fs = require('fs');
2 | const path = require('path');
3 |
4 | function validateFlags() {
5 | const countries = JSON.parse(fs.readFileSync('country-lists/json-country-list.json'));
6 | const flagDir = 'flags/svg/';
7 | const missingFlags = [];
8 |
9 | countries.forEach(country => {
10 | const flagPath = path.join(flagDir, `${country.code}.svg`);
11 | if (!fs.existsSync(flagPath)) {
12 | missingFlags.push(country.code);
13 | }
14 | });
15 |
16 | if (missingFlags.length > 0) {
17 | console.error('Missing flags for:', missingFlags.join(', '));
18 | process.exit(1);
19 | }
20 |
21 | console.log(`✅ All ${countries.length} country flags present!`);
22 | }
23 |
24 | validateFlags();
--------------------------------------------------------------------------------
/flags/svg/TL.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/BB.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/TO.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/README.md:
--------------------------------------------------------------------------------
1 | # SVG Flags
2 |
3 | These flags have been added from Flagpack.
4 |
5 | ## Usage
6 |
7 | ### Direct Access
8 | ```html
9 |
10 | ```
11 |
12 | ### Programmatic Access
13 | ```javascript
14 | // Load country to flag mapping
15 | fetch('flags/country-mapping.json')
16 | .then(response => response.json())
17 | .then(mapping => {
18 | const flagFile = mapping['US']; // "US.svg"
19 | console.log(`Flag: flags/svg/${flagFile}`);
20 | });
21 | ```
22 |
23 | ## Validation
24 |
25 | Run flag validation:
26 | ```bash
27 | node scripts/validate-flags.js
28 | ```
29 |
30 | ## Source
31 |
32 | Flags sourced from [Flagpack](https://flagpack.xyz/) under MIT license.
33 |
--------------------------------------------------------------------------------
/flags/svg/EH.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/BW.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/CZ.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/COMMUNITY_STATS.md:
--------------------------------------------------------------------------------
1 | # Community Statistics
2 |
3 | *This file is automatically updated monthly.*
4 |
5 | ## Repository Metrics
6 |
7 | ### GitHub Stats
8 | - **Stars**: 480
9 | - **Forks**: 657
10 | - **Open Issues**: N/A
11 | - **Last Updated**: $(date +'%Y-%m-%d')
12 |
13 | ## Data Coverage
14 | - **Countries**: 250+ (including territories)
15 | - **Formats**: MySQL, JSON, PHP, Python, Joomla
16 | - **Flag Assets**: 255+ SVG files
17 | - **Time Zones**: Comprehensive coverage
18 |
19 | ## Community Activity (Last 30 Days)
20 | - **Commits**: 2025-11-20T10:20:17Z
21 | - **Contributors**: Active community
22 |
23 | ## Usage Impact
24 | This repository helps thousands of developers worldwide integrate standardized country data into their applications.
25 |
26 | ---
27 | *Generated on $(date)*
28 |
--------------------------------------------------------------------------------
/flags/svg/GR.svg:
--------------------------------------------------------------------------------
1 |
13 |
--------------------------------------------------------------------------------
/flags/svg/MU.svg:
--------------------------------------------------------------------------------
1 |
17 |
--------------------------------------------------------------------------------
/flags/svg/TT.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/NE.svg:
--------------------------------------------------------------------------------
1 |
17 |
--------------------------------------------------------------------------------
/flags/svg/KW.svg:
--------------------------------------------------------------------------------
1 |
17 |
--------------------------------------------------------------------------------
/flags/svg/BF.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/MA.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/CA.svg:
--------------------------------------------------------------------------------
1 |
10 |
--------------------------------------------------------------------------------
/flags/svg/AW.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/LR.svg:
--------------------------------------------------------------------------------
1 |
14 |
--------------------------------------------------------------------------------
/flags/svg/VN.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/IL.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/CN.svg:
--------------------------------------------------------------------------------
1 |
10 |
--------------------------------------------------------------------------------
/flags/svg/LY.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/TZ.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/AG.svg:
--------------------------------------------------------------------------------
1 |
13 |
--------------------------------------------------------------------------------
/flags/svg/GG.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/SS.svg:
--------------------------------------------------------------------------------
1 |
14 |
--------------------------------------------------------------------------------
/flags/svg/CW.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/PA.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/KN.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/SC.svg:
--------------------------------------------------------------------------------
1 |
18 |
--------------------------------------------------------------------------------
/flags/svg/MK.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/TN.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/CD.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/MR.svg:
--------------------------------------------------------------------------------
1 |
17 |
--------------------------------------------------------------------------------
/flags/svg/TR.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/TW.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/FM.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/BA.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/GL.svg:
--------------------------------------------------------------------------------
1 |
22 |
--------------------------------------------------------------------------------
/flags/svg/HN.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/NP.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/AZ.svg:
--------------------------------------------------------------------------------
1 |
17 |
--------------------------------------------------------------------------------
/MIT-License:
--------------------------------------------------------------------------------
1 | MIT License
2 |
3 | Copyright (c) [2017] [raramuridesign]
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.
22 |
--------------------------------------------------------------------------------
/flags/svg/GE.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/MV.svg:
--------------------------------------------------------------------------------
1 |
19 |
--------------------------------------------------------------------------------
/flags/svg/ET.svg:
--------------------------------------------------------------------------------
1 |
19 |
--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/feature-request.yml:
--------------------------------------------------------------------------------
1 | name: Feature Request
2 | description: Suggest new features or data formats
3 | title: "[Feature] "
4 | labels: ["enhancement", "feature-request"]
5 | body:
6 | - type: textarea
7 | id: problem
8 | attributes:
9 | label: Problem/Use Case
10 | description: What's the problem this feature would solve?
11 | placeholder: "Describe the issue or limitation you're facing"
12 | validations:
13 | required: true
14 | - type: textarea
15 | id: solution
16 | attributes:
17 | label: Proposed Solution
18 | description: How would you like to see this implemented?
19 | placeholder: "Describe your proposed solution"
20 | validations:
21 | required: true
22 | - type: textarea
23 | id: alternatives
24 | attributes:
25 | label: Alternative Solutions
26 | description: Have you considered any alternative approaches?
27 | placeholder: "List any alternative solutions you've considered"
28 | - type: textarea
29 | id: additional-context
30 | attributes:
31 | label: Additional Context
32 | description: Add any other context or screenshots about the feature request
--------------------------------------------------------------------------------
/flags/svg/DJ.svg:
--------------------------------------------------------------------------------
1 |
22 |
--------------------------------------------------------------------------------
/flags/svg/CU.svg:
--------------------------------------------------------------------------------
1 |
22 |
--------------------------------------------------------------------------------
/flags/svg/PR.svg:
--------------------------------------------------------------------------------
1 |
22 |
--------------------------------------------------------------------------------
/flags/svg/AQ.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/MY.svg:
--------------------------------------------------------------------------------
1 |
14 |
--------------------------------------------------------------------------------
/flags/svg/WS.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | # Auto-generated files
2 | COMMUNITY_STATS.md
3 |
4 | # OS generated files
5 | .DS_Store
6 | .DS_Store?
7 | ._*
8 | .Spotlight-V100
9 | .Trashes
10 | ehthumbs.db
11 | Thumbs.db
12 |
13 | # IDE files
14 | .vscode/
15 | .idea/
16 | *.swp
17 | *.swo
18 | *~
19 |
20 | # Node.js
21 | node_modules/
22 | npm-debug.log*
23 | yarn-debug.log*
24 | yarn-error.log*
25 |
26 | # Logs
27 | logs
28 | *.log
29 |
30 | # Runtime data
31 | pids
32 | *.pid
33 | *.seed
34 | *.pid.lock
35 |
36 | # Coverage directory used by tools like istanbul
37 | coverage/
38 |
39 | # nyc test coverage
40 | .nyc_output
41 |
42 | # Dependency directories
43 | jspm_packages/
44 |
45 | # Optional npm cache directory
46 | .npm
47 |
48 | # Optional REPL history
49 | .node_repl_history
50 |
51 | # Output of 'npm pack'
52 | *.tgz
53 |
54 | # Yarn Integrity file
55 | .yarn-integrity
56 |
57 | # dotenv environment variables file
58 | .env
59 |
60 | # Temporary folders
61 | tmp/
62 | temp/
63 |
64 | # Build outputs
65 | dist/
66 | build/
67 |
68 | # Database files
69 | *.db
70 | *.sqlite
71 | *.sqlite3
72 |
73 | # Backup files
74 | *.bak
75 | *.backup
76 | *.old
77 |
78 | # Package lock files (optional - uncomment if you want to ignore)
79 | # package-lock.json
80 | # yarn.lock
--------------------------------------------------------------------------------
/flags/svg/JO.svg:
--------------------------------------------------------------------------------
1 |
23 |
--------------------------------------------------------------------------------
/flags/svg/TK.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/SV.svg:
--------------------------------------------------------------------------------
1 |
19 |
--------------------------------------------------------------------------------
/flags/svg/LB.svg:
--------------------------------------------------------------------------------
1 |
11 |
--------------------------------------------------------------------------------
/flags/svg/NA.svg:
--------------------------------------------------------------------------------
1 |
17 |
--------------------------------------------------------------------------------
/flags/svg/MH.svg:
--------------------------------------------------------------------------------
1 |
17 |
--------------------------------------------------------------------------------
/flags/svg/SG.svg:
--------------------------------------------------------------------------------
1 |
16 |
--------------------------------------------------------------------------------
/flags/svg/IN.svg:
--------------------------------------------------------------------------------
1 |
18 |
--------------------------------------------------------------------------------
/flags/svg/KM.svg:
--------------------------------------------------------------------------------
1 |
19 |
--------------------------------------------------------------------------------
/flags/svg/ZA.svg:
--------------------------------------------------------------------------------
1 |
18 |
--------------------------------------------------------------------------------
/flags/svg/IQ.svg:
--------------------------------------------------------------------------------
1 |
17 |
--------------------------------------------------------------------------------
/flags/svg/SB.svg:
--------------------------------------------------------------------------------
1 |
18 |
--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/data-correction.yml:
--------------------------------------------------------------------------------
1 | name: Data Correction Request
2 | description: Report incorrect or outdated country data
3 | title: "[Data Correction] "
4 | labels: ["data-correction", "help-wanted"]
5 | body:
6 | - type: input
7 | id: country-code
8 | attributes:
9 | label: Country Code
10 | description: ISO 3166-2 alpha-2 code (e.g., US, GB, DE)
11 | placeholder: "US"
12 | validations:
13 | required: true
14 | - type: textarea
15 | id: current-data
16 | attributes:
17 | label: Current Data
18 | description: What is currently shown
19 | placeholder: "Current country name, code, etc."
20 | validations:
21 | required: true
22 | - type: textarea
23 | id: proposed-correction
24 | attributes:
25 | label: Proposed Correction
26 | description: What should it be changed to
27 | placeholder: "Correct country name, code, etc."
28 | validations:
29 | required: true
30 | - type: textarea
31 | id: source
32 | attributes:
33 | label: Source/Reference
34 | description: Please provide a reliable source for this correction
35 | placeholder: "Link to official government site, ISO standard, etc."
36 | validations:
37 | required: true
38 | - type: textarea
39 | id: additional-info
40 | attributes:
41 | label: Additional Information
42 | description: Any additional context or files affected
43 | placeholder: "Which formats are affected, etc."
--------------------------------------------------------------------------------
/flags/svg/LS.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/BQ-SE.svg:
--------------------------------------------------------------------------------
1 |
20 |
--------------------------------------------------------------------------------
/flags/svg/CX.svg:
--------------------------------------------------------------------------------
1 |
14 |
--------------------------------------------------------------------------------
/flags/svg/BI.svg:
--------------------------------------------------------------------------------
1 |
17 |
--------------------------------------------------------------------------------
/flags/svg/PY.svg:
--------------------------------------------------------------------------------
1 |
22 |
--------------------------------------------------------------------------------
/flags/svg/MW.svg:
--------------------------------------------------------------------------------
1 |
17 |
--------------------------------------------------------------------------------
/flags/svg/VE.svg:
--------------------------------------------------------------------------------
1 |
18 |
--------------------------------------------------------------------------------
/flags/svg/KE.svg:
--------------------------------------------------------------------------------
1 |
22 |
--------------------------------------------------------------------------------
/flags/svg/MN.svg:
--------------------------------------------------------------------------------
1 |
13 |
--------------------------------------------------------------------------------
/flags/svg/MT.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/KR.svg:
--------------------------------------------------------------------------------
1 |
13 |
--------------------------------------------------------------------------------
/flags/svg/UZ.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/GI.svg:
--------------------------------------------------------------------------------
1 |
21 |
--------------------------------------------------------------------------------
/flags/svg/CC.svg:
--------------------------------------------------------------------------------
1 |
9 |
--------------------------------------------------------------------------------
/flags/svg/TF.svg:
--------------------------------------------------------------------------------
1 |
24 |
--------------------------------------------------------------------------------
/flags/svg/OM.svg:
--------------------------------------------------------------------------------
1 |
18 |
--------------------------------------------------------------------------------
/flags/svg/MZ.svg:
--------------------------------------------------------------------------------
1 |
28 |
--------------------------------------------------------------------------------
/flags/svg/PG.svg:
--------------------------------------------------------------------------------
1 |
13 |
--------------------------------------------------------------------------------
/flags/svg/GD.svg:
--------------------------------------------------------------------------------
1 |
21 |
--------------------------------------------------------------------------------
/flags/svg/GB-NIR.svg:
--------------------------------------------------------------------------------
1 |
28 |
--------------------------------------------------------------------------------
/flags/svg/GB-UKM.svg:
--------------------------------------------------------------------------------
1 |
28 |
--------------------------------------------------------------------------------
/flags/svg/HK.svg:
--------------------------------------------------------------------------------
1 |
19 |
--------------------------------------------------------------------------------
/flags/svg/RW.svg:
--------------------------------------------------------------------------------
1 |
17 |
--------------------------------------------------------------------------------
/flags/svg/NI.svg:
--------------------------------------------------------------------------------
1 |
28 |
--------------------------------------------------------------------------------
/flags/svg/EG.svg:
--------------------------------------------------------------------------------
1 |
22 |
--------------------------------------------------------------------------------
/CHANGELOG.md:
--------------------------------------------------------------------------------
1 | # Changelog
2 |
3 | All notable changes to this project will be documented in this file.
4 |
5 | The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6 | and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7 |
8 | ## [Unreleased]
9 |
10 | ### Added
11 | - Flag integration with country mapping JSON (`flags/country-mapping.json`)
12 | - Flag validation script (`scripts/validate-flags.js`)
13 | - Enhanced documentation across all README files
14 | - GitHub issue templates for structured community feedback
15 | - Community engagement files (CONTRIBUTORS.md, CONTRIBUTING.md)
16 |
17 | ### Changed
18 | - Updated country names for accuracy:
19 | - "East Timor" → "Timor-Leste"
20 | - "Libyan Arab Jamahiriya" → "Libya"
21 | - "Netherlands Antilles" → "Netherlands Antilles (dissolved)"
22 | - "France, Metropolitan" → "France, Metropolitan (obsolete)"
23 | - "Reunion" → "Réunion"
24 | - Standardized data formats across all file types
25 | - Improved README.md with comprehensive usage examples
26 | - Enhanced docs/index.md with detailed technical documentation
27 |
28 | ### Fixed
29 | - Corrected country name inconsistencies across formats
30 | - Fixed numeric codes (Timor-Leste: 670 → 626)
31 | - Standardized "the" usage in country names
32 | - Corrected spelling errors in JSON files ("Democratis" → "Democratic", "Cook Island" → "Cook Islands")
33 |
34 | ## [1.0.0] - 2025-10-22
35 |
36 | ### Added
37 | - Initial release with country lists in multiple formats:
38 | - MySQL dumps (basic, detailed, InnoDB)
39 | - JSON arrays (standard and extended)
40 | - PHP associative arrays
41 | - Python tuple lists
42 | - Joomla custom field format
43 | - SVG flag assets for all countries and territories
44 | - Time zone data with GMT offsets
45 | - Basic documentation and usage examples
46 |
47 | ### Changed
48 | - Migrated from basic country list to comprehensive geographic data repository
49 | - Expanded from simple code/name pairs to detailed country information
50 |
51 | ### Deprecated
52 | - Netherlands Antilles (dissolved October 2010)
53 | - France, Metropolitan (administrative term no longer used)
54 |
55 | ### Removed
56 | - Outdated country name variants
57 |
58 | ### Fixed
59 | - Initial data consistency across all formats
60 | - Proper UTF-8 encoding for international characters
--------------------------------------------------------------------------------
/flags/svg/TJ.svg:
--------------------------------------------------------------------------------
1 |
13 |
--------------------------------------------------------------------------------
/flags/svg/CV.svg:
--------------------------------------------------------------------------------
1 |
29 |
--------------------------------------------------------------------------------
/flags/svg/SK.svg:
--------------------------------------------------------------------------------
1 |
24 |
--------------------------------------------------------------------------------
/flags/svg/GQ.svg:
--------------------------------------------------------------------------------
1 |
22 |
--------------------------------------------------------------------------------
/flags/svg/IM.svg:
--------------------------------------------------------------------------------
1 |
22 |
--------------------------------------------------------------------------------
/flags/svg/BQ-BO.svg:
--------------------------------------------------------------------------------
1 |
17 |
--------------------------------------------------------------------------------
/.github/workflows/community-stats.yml:
--------------------------------------------------------------------------------
1 | name: Community Stats
2 | on:
3 | schedule:
4 | - cron: '0 0 1 * *' # Monthly on the 1st
5 | workflow_dispatch: # Manual trigger
6 |
7 | jobs:
8 | update-stats:
9 | runs-on: ubuntu-latest
10 | permissions:
11 | contents: write
12 | steps:
13 | - name: Checkout repository
14 | uses: actions/checkout@v4
15 | with:
16 | token: ${{ secrets.GITHUB_TOKEN }}
17 |
18 | - name: Setup Node.js
19 | uses: actions/setup-node@v4
20 | with:
21 | node-version: '18'
22 |
23 | - name: Generate community statistics
24 | run: |
25 | # Create community stats file
26 | cat > COMMUNITY_STATS.md << 'EOF'
27 | # Community Statistics
28 |
29 | *This file is automatically updated monthly.*
30 |
31 | ## Repository Metrics
32 |
33 | ### GitHub Stats
34 | - **Stars**: ${{ github.event.repository.stargazers_count || 'N/A' }}
35 | - **Forks**: ${{ github.event.repository.forks_count || 'N/A' }}
36 | - **Open Issues**: ${{ github.event.repository.open_issues_count || 'N/A' }}
37 | - **Last Updated**: $(date +'%Y-%m-%d')
38 |
39 | ## Data Coverage
40 | - **Countries**: 250+ (including territories)
41 | - **Formats**: MySQL, JSON, PHP, Python, Joomla
42 | - **Flag Assets**: 255+ SVG files
43 | - **Time Zones**: Comprehensive coverage
44 |
45 | ## Community Activity (Last 30 Days)
46 | - **Commits**: ${{ github.event.repository.updated_at || 'N/A' }}
47 | - **Contributors**: Active community
48 |
49 | ## Usage Impact
50 | This repository helps thousands of developers worldwide integrate standardized country data into their applications.
51 |
52 | ---
53 | *Generated on $(date)*
54 | EOF
55 |
56 | - name: Run validation checks
57 | run: |
58 | echo "Running validation checks..."
59 | if [ -f "scripts/validate-flags.js" ]; then
60 | node scripts/validate-flags.js || echo "Flag validation failed"
61 | else
62 | echo "Validation script not found"
63 | fi
64 |
65 | - name: Commit and push changes
66 | run: |
67 | git config --local user.email "action@github.com"
68 | git config --local user.name "GitHub Action"
69 | git add COMMUNITY_STATS.md
70 | if git diff --staged --quiet; then
71 | echo "No changes to commit"
72 | else
73 | git commit -m "Update community statistics [$(date +'%Y-%m')]"
74 | git push
75 | fi
76 | continue-on-error: true
--------------------------------------------------------------------------------
/flags/svg/UM.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/US.svg:
--------------------------------------------------------------------------------
1 |
12 |
--------------------------------------------------------------------------------
/flags/svg/MO.svg:
--------------------------------------------------------------------------------
1 |
23 |
--------------------------------------------------------------------------------
/flags/svg/UG.svg:
--------------------------------------------------------------------------------
1 |
24 |
--------------------------------------------------------------------------------
/flags/svg/KG.svg:
--------------------------------------------------------------------------------
1 |
15 |
--------------------------------------------------------------------------------
/flags/svg/AU.svg:
--------------------------------------------------------------------------------
1 |
31 |
--------------------------------------------------------------------------------