Blade Flags Laravel Package

What's Changed

• Laravel 13.x compatibility (#28)
• Fix flag components not respecting CSS size classes
• Fix tests for PHPUnit 12 compatibility

Fix

• Fix flag components not respecting CSS size classes (size-4, shrink-0, etc.)
  • Strip hardcoded width/height from SVGs, use width:100%;height:100% so the SVG fills its container
  • Add display:inline-flex to the span wrapper

Affected packages: [@blade-flags](https://github.com/blade-flags)/core, [@blade-flags](https://github.com/blade-flags)/react, [@blade-flags](https://github.com/blade-flags)/vue

This package aims for broad compatibility by mirroring upstream flag collections. Inclusion of any flag does not imply endorsement. The author of this package stands with Palestine (the Palestine flag is featured in the project cover). If you want to exclude specific flags, you can do so in your application/UI, or exclude them during the build via bin/build.sh.

This package aims for broad compatibility by mirroring upstream flag collections. Inclusion of any flag does not imply endorsement. The author of this package stands with Palestine (the Palestine flag is featured in the project cover). If you want to exclude specific flags, you can do so in your application/UI, or exclude them during the build via bin/build.sh.

Fixed

• Add README files to npm packages

Initial Release — JavaScript Packages

First release of the JavaScript flag packages, providing the same 1,759 SVG flags from blade-flags as tree-shakeable JS modules.

Packages

Installation

npm install [@blade-flags](https://github.com/blade-flags)/core [@blade-flags](https://github.com/blade-flags)/vue   # Vue
npm install [@blade-flags](https://github.com/blade-flags)/core [@blade-flags](https://github.com/blade-flags)/react  # React
npm install [@blade-flags](https://github.com/blade-flags)/core                     # Vanilla JS

Tree-Shaking

Every flag is a named export — import only what you need:

import { countryUs, countryGb } from '[@blade-flags](https://github.com/blade-flags)/core/flags/circle'

Or use the full variant map for dynamic runtime lookup:

import { circleFlags } from '[@blade-flags](https://github.com/blade-flags)/core/flags/circle'
import { resolveFlag } from '[@blade-flags](https://github.com/blade-flags)/core'
const svg = resolveFlag(circleFlags, 'us')

What's New

Circle & Flat Flag Variants

The package now ships with three flag styles — 1,759 flags total:

Language Flag Overrides

Override default language-to-country mappings via config:

// config/blade-flags.php
'language_overrides' => [
    'ar' => ['default' => 'sa'],
    'en' => ['default' => 'us'],
],

JavaScript Packages

The same flags are now available as npm packages for Vue, React, and vanilla JS:

• [@blade-flags](https://github.com/blade-flags)/core — SVG strings as tree-shakeable JS modules
• [@blade-flags](https://github.com/blade-flags)/vue — <Flag> component for Vue 3
• [@blade-flags](https://github.com/blade-flags)/react — <Flag> component for React 18+

npm install [@blade-flags](https://github.com/blade-flags)/core [@blade-flags](https://github.com/blade-flags)/vue

Full Changelog: https://github.com/MohmmedAshraf/blade-flags/compare/1.5.4...1.6.0

What's Changed

• Add home nation country flags by @michaeljmeadows in https://github.com/MohmmedAshraf/blade-flags/pull/26

New Contributors

• @michaeljmeadows made their first contribution in https://github.com/MohmmedAshraf/blade-flags/pull/26

Full Changelog: https://github.com/MohmmedAshraf/blade-flags/compare/1.5.3...1.5.4

What's Changed

• Laravel 12.x Compatibility by @laravel-shift in https://github.com/MohmmedAshraf/blade-flags/pull/24

Full Changelog: https://github.com/MohmmedAshraf/blade-flags/compare/1.5.2...1.5.3

What's Changed

• Updated Syrian Flag to the New Free Syria Green Flag by @JamelSyr in https://github.com/MohmmedAshraf/blade-flags/pull/23

New Contributors

• @JamelSyr made their first contribution in https://github.com/MohmmedAshraf/blade-flags/pull/23

Full Changelog: https://github.com/MohmmedAshraf/blade-flags/compare/1.5.1...1.5.2

What's Changed

• Fix a typo in the README file. by @hackedhorizon in https://github.com/MohmmedAshraf/blade-flags/pull/19
• Flag catalan language-ca by @adriallongarriu in https://github.com/MohmmedAshraf/blade-flags/pull/18

New Contributors

• @hackedhorizon made their first contribution in https://github.com/MohmmedAshraf/blade-flags/pull/19
• @adriallongarriu made their first contribution in https://github.com/MohmmedAshraf/blade-flags/pull/18

Full Changelog: https://github.com/MohmmedAshraf/blade-flags/compare/1.5.0...1.5.1

What's Changed

• Laravel 11.x Compatibility by @laravel-shift in https://github.com/MohmmedAshraf/blade-flags/pull/14
• Update Github workflow by @MohmmedAshraf in https://github.com/MohmmedAshraf/blade-flags/pull/16

New Contributors

• @laravel-shift made their first contribution in https://github.com/MohmmedAshraf/blade-flags/pull/14
• @MohmmedAshraf made their first contribution in https://github.com/MohmmedAshraf/blade-flags/pull/16

Full Changelog: https://github.com/MohmmedAshraf/blade-flags/compare/1.2.1...1.5.0

Fix fallback icon not working!

Add support for Laravel 10

Add support for Laravel 8

Add missing flags #8 , #9 Add a default fallback flag if the requested flag is missing in the config

Add Kurdistan Flag for the Kurdish language #4 by @renwarkurd Correct the language code for Iraq Arabic language #5 by @renwarkurd

Correct the Basque language flag (#1)

Use twemoji flags instated of circle-flags

Initial release