fix: replace dead dev-branch links and repair README symlink

CONTRIBUTING.md

@@ -8,7 +8,7 @@ Thank you for your interest in contributing to **Stac**! We value your time and
 
 ### 1. **Understand Stac**
 If you are new to Stac, we recommend you:
-- Check out the [README](./README.md) for an overview of the framework.
+- Check out the [README](./packages/stac/README.md) for an overview of the framework.
 - Explore the [documentation](https://docs.stac.dev/).
 - Familiarize yourself with the codebase by browsing the repository.
 

README.md

@@ -1 +1 @@
-packages/stac/README.md
+packages/stac/README.md

docs/changelog.mdx

@@ -290,4 +290,4 @@ If upgrading from pre-1.0 versions, please review these changes carefully.
 
 - **GitHub**: [StacDev/stac](https://github.com/StacDev/stac)
 - **Discord**: [Join the community](https://discord.com/invite/vTGsVRK86V)
-- **Twitter**: Follow [@StacDev](https://twitter.com/StacDev) for announcements
+- **X**: Follow [@stac_dev](https://x.com/stac_dev) for announcements

docs/dsl.mdx

@@ -302,5 +302,5 @@ Stac(routeName: 'home_screen')
 
 - Learn about [available widgets](/widgets/align) you can use in DSL
 - Explore [actions](/actions/navigate) for handling user interactions
-- Check out the [movie app example](https://github.com/StacDev/stac/tree/dev/examples/movie_app) for a complete DSL project
+- Check out the [movie app example](https://github.com/StacDev/stac/tree/main/examples/movie_app) for a complete DSL project
 - Read about [theming](/concepts/theming) for customizing your app's appearance

docs/introduction.mdx

@@ -92,7 +92,7 @@ Built by developers, for developers. Stac is open source and community-driven.
   <Card
     title="Contribute"
     icon="git-branch"
-    href="https://github.com/StacDev/stac/blob/dev/CONTRIBUTING.md"
+    href="https://github.com/StacDev/stac/blob/main/CONTRIBUTING.md"
   >
     Submit PRs, report bugs, or suggest features. Every contribution matters.
   </Card>

docs/styles/border.mdx

@@ -216,6 +216,6 @@ StacContainer(
 
 ## See Also
 
-- [Border Side](./border_side.md) - Learn about StacBorderSide properties
-- [Border Radius](./border_radius.md) - Learn about border radius configuration
+- [Border Side](/styles/border_side) - Learn about StacBorderSide properties
+- [Border Radius](/styles/border_radius) - Learn about border radius configuration
 

docs/styles/border_side.mdx

@@ -10,7 +10,7 @@ To know more about the BorderSide class in Flutter, refer to the [official docum
 
 :::info
 
-BorderSide is used with the new individual border sides feature in [StacBorder](./border.md). You can now specify different border sides for top, right, bottom, and left individually.
+BorderSide is used with the new individual border sides feature in [StacBorder](/styles/border). You can now specify different border sides for top, right, bottom, and left individually.
 
 :::
 
@@ -47,5 +47,5 @@ StacBorderSide(
 
 ## See Also
 
-- [Border](./border.md) - Learn about using individual border sides in StacBorder
+- [Border](/styles/border) - Learn about using individual border sides in StacBorder
 

docs/tools/vscode.mdx

@@ -25,7 +25,7 @@ Or in VS Code, press `Cmd+Shift+X` (Mac) or `Ctrl+Shift+X` (Windows/Linux) to op
 3. **Launch a live preview** — run **`Stac: Open Preview`** to open a side-by-side preview of the active `@StacScreen`.
 
 <Frame>
-  <img src="https://raw.githubusercontent.com/StacDev/stac/dev/tools/stac-vscode/media/stac_preview.png" alt="Stac Live Preview" />
+  <img src="https://raw.githubusercontent.com/StacDev/stac/main/tools/stac-vscode/media/stac_preview.png" alt="Stac Live Preview" />
 </Frame>
 
 ## Use live preview

docs/widgets/carousel_view.mdx

@@ -51,7 +51,7 @@ export const carouselViewPreviewJson = {
 export const carouselViewPreviewSrc = `${PLAYGROUND_BASE_URL}/embed`;
 
 The Stac CarouselView allows you to build a Flutter CarouselView widget using JSON.
-To know more about the CarouselView widget in Flutter, refer to the [official documentation](https://api.flutter.dev/flutter/widgets/Carousel-class.html).
+To know more about the CarouselView widget in Flutter, refer to the [official documentation](https://api.flutter.dev/flutter/material/CarouselView-class.html).
 
 ## Properties
 

docs/widgets/circle_avatar.mdx

@@ -9,7 +9,7 @@ export const circleAvatarPreviewJson = {
   "type": "circleAvatar",
   "backgroundColor": "#FF0000",
   "foregroundColor": "#FFFFFF",
-  "backgroundImage": "https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/companies/bettrdo.jpg",
+  "backgroundImage": "https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/companies/bettrdo.jpg",
   "radius": 50,
   "child": {
     "type": "text",
@@ -45,7 +45,7 @@ To know more about the circle avatar widget in Flutter, refer to the [official d
 StacCircleAvatar(
   backgroundColor: StacColors.red,
   foregroundColor: StacColors.white,
-  backgroundImage: 'https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/companies/bettrdo.jpg',
+  backgroundImage: 'https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/companies/bettrdo.jpg',
   radius: 50,
   child: StacText(data: 'A'),
 )
@@ -59,7 +59,7 @@ StacCircleAvatar(
   "type": "circleAvatar",
   "backgroundColor": "#FF0000",
   "foregroundColor": "#FFFFFF",
-  "backgroundImage": "https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/companies/bettrdo.jpg",
+  "backgroundImage": "https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/companies/bettrdo.jpg",
   "radius": 50,
   "child": {
     "type": "text",

docs/widgets/clip_rrect.mdx

@@ -304,5 +304,5 @@ StacClipRRect(
 
 ## Related Widgets
 
-- [Container](container.md) - Often used as a child of ClipRRect
-- [Card](card.md) - A pre-styled container with elevation and rounded corners
+- [Container](/widgets/container) - Often used as a child of ClipRRect
+- [Card](/widgets/card) - A pre-styled container with elevation and rounded corners

docs/widgets/icon.mdx

@@ -29,7 +29,7 @@ To know more about the icon widget in Flutter, refer to the [official documentat
 | semanticLabel | `String`              | The semantic label for the icon.                                    |
 | textDirection | `StacTextDirection`   | The text direction for the icon.                                    |
 
-> Note: To check the available icons, refer to  [Icon utils](https://github.com/StacDev/stac/blob/dev/packages/stac/lib/src/utils/icon_utils.dart).
+> Note: To check the available icons, refer to  [Icon utils](https://github.com/StacDev/stac/blob/main/packages/stac/lib/src/utils/icon_utils.dart).
 
 ## Example
 

docs/widgets/table.mdx

@@ -139,10 +139,10 @@ To know more about the Table widget in Flutter, refer to the [official documenta
 
 | Property                 | Type                               | Description                                                                                                                                                                                                     |
 |--------------------------|------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
-| columnWidths             | `Map<int, StacTableColumnWidth>`   | Determines the column width on a column by column basis, if a particular column entry has null width `defaultColumnWidth` is used. See [`StacTableColumnWidth`](./../styles_and_attributes/table_column_width) |
-| defaultColumnWidth       | `StacTableColumnWidth`             | Determines the  default column width. Defaults to `flexColumnWidth`. See [`StacTableColumnWidth`](./../styles_and_attributes/table_column_width)                                                               |
+| columnWidths             | `Map<int, StacTableColumnWidth>`   | Determines the column width on a column by column basis, if a particular column entry has null width `defaultColumnWidth` is used. See [`StacTableColumnWidth`](/styles/table_column_width) |
+| defaultColumnWidth       | `StacTableColumnWidth`             | Determines the  default column width. Defaults to `flexColumnWidth`. See [`StacTableColumnWidth`](/styles/table_column_width)                                                               |
 | textDirection            | `StacTextDirection`                | Determines the direction in which the columns are ordered. Can be `rtl` or `ltr`. Defaults to `rtl`.                                                                                                            |
-| border                   | `StacTableBorder`                  | Defines the border style for `StacTable`. See [`StacTableBorder`](./../styles_and_attributes/table_border).                                                                                                   |
+| border                   | `StacTableBorder`                  | Defines the border style for `StacTable`. See [`StacTableBorder`](/styles/table_border).                                                                                                   |
 | defaultVerticalAlignment | `StacTableCellVerticalAlignment`   | Defines the verticalAlignment for the cells that don't specify a verticalAlignment. Can be `top`, `middle`, `bottom`, `baseline`, `fill` & `intrinsicHeight` Defaults to `top`.                                 |
 | textBaseLine             | `StacTextBaseline`                 | Defines the text baseline to use when verticalAlignment is `baseline`. Can be `alphabetic` or `ideographic`. There is no default value.                                                                         |
 | children                 | `List<StacTableRow>`               | Rows that will be populated in the table. See [`StacTableRow`](./table_row).                                                                                                                                   |

packages/stac/README.md

@@ -178,7 +178,7 @@ StacWidget primaryButton({
 ```
 </td>
 <td width="30%" align="center" valign="top">
-  <img src="https://github.com/StacDev/stac/blob/dev/assets/login.png" alt="Stac Form Screen" height="840" />
+  <img src="https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/login.png" alt="Stac Form Screen" height="840" />
 </td>
 </tr>
 </table>
@@ -189,7 +189,7 @@ StacWidget primaryButton({
 - 🚀 **[Quick Start](https://docs.stac.dev/quickstart)** – Get up and running in minutes
 - 🛠️ **[Stac CLI](https://docs.stac.dev/cli)** – Command-line tools for development
 - 🎛️ **[Stac Console](https://console.stac.dev/)** – Web interface for managing your app
-- 🤝 **[Contributing](https://github.com/StacDev/stac/blob/dev/CONTRIBUTING.md)** – Help build Stac
+- 🤝 **[Contributing](https://github.com/StacDev/stac/blob/main/CONTRIBUTING.md)** – Help build Stac
 
 ## License
 
@@ -207,7 +207,7 @@ This project is licensed under the MIT License - see the [LICENSE](/LICENSE) fil
 
 <p align="center">
 <a href="https://github.com/StacDev/stac/graphs/contributors">
-  <img src="https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/contributor_banner.png" alt="Stac Contributors"/>
+  <img src="https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/contributor_banner.png" alt="Stac Contributors"/>
 </a>
 </p>
 

packages/stac_logger/pubspec.yaml

@@ -2,7 +2,7 @@ name: stac_logger
 description: A lightweight and reusable logging utility for the Stac framework.
 version: 1.1.0
 homepage: https://github.com/StacDev/stac
-repository: https://github.com/StacDev/stac/tree/dev/packages/stac_logger
+repository: https://github.com/StacDev/stac/tree/main/packages/stac_logger
 
 environment:
   sdk: ^3.8.1

stac_playground/lib/app/cubit/home_cubit.dart

@@ -327,7 +327,7 @@ const Map<String, dynamic> helloStacSample = {
         {
           "type": "image",
           "src":
-              "https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/Welcome%20to.png",
+              "https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/Welcome%20to.png",
         },
         {
           "type": "text",
@@ -396,7 +396,7 @@ const Map<String, dynamic> helloStacSample = {
                   "child": {
                     "type": "image",
                     "src":
-                        "https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/github.png"
+                        "https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/github.png"
                   }
                 },
                 {
@@ -425,7 +425,7 @@ const Map<String, dynamic> helloStacSample = {
                   "child": {
                     "type": "image",
                     "src":
-                        "https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/x.png"
+                        "https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/x.png"
                   }
                 },
                 {
@@ -454,7 +454,7 @@ const Map<String, dynamic> helloStacSample = {
                   "child": {
                     "type": "image",
                     "src":
-                        "https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/linkedin.png"
+                        "https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/linkedin.png"
                   }
                 },
                 {
@@ -503,7 +503,7 @@ StacWidget helloStac() {
           StacSizedBox(height: 40),
           StacImage(
             src:
-                'https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/Welcome%20to.png',
+                'https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/Welcome%20to.png',
           ),
           StacText(
             data: 'Stac Playground',
@@ -541,17 +541,17 @@ StacWidget helloStac() {
             children: [
               _socialRow(
                 icon:
-                    'https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/github.png',
+                    'https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/github.png',
                 handle: 'github.com/StacDev',
               ),
               _socialRow(
                 icon:
-                    'https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/x.png',
+                    'https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/x.png',
                 handle: 'x.com/stac_dev',
               ),
               _socialRow(
                 icon:
-                    'https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/linkedin.png',
+                    'https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/linkedin.png',
                 handle: '/company/StacDev',
               ),
             ],

stac_playground/web/index.html

@@ -9,15 +9,15 @@
 
   <meta property="og:title" content="Stac Playground" />
   <meta property="og:description" content="A sandbox for Stac Server-Driven UI Framework" />
-  <meta property="og:image" content="https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/playground.png" />
+  <meta property="og:image" content="https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/playground.png" />
 
   <!-- Twitter meta tags -->
   <meta name="twitter:card" content="summary_large_image">
   <meta name="twitter:site" content="@stac_dev">
   <meta name="twitter:creator" content="@stac_dev">
   <meta name="twitter:title" content="Stac Playground">
   <meta name="twitter:description" content="A sandbox for Stac Server-Driven UI Framework">
-  <meta name="twitter:image" content="https://raw.githubusercontent.com/StacDev/stac/refs/heads/dev/assets/playground.png">
+  <meta name="twitter:image" content="https://raw.githubusercontent.com/StacDev/stac/refs/heads/main/assets/playground.png">
 
   <!-- iOS meta tags & icons -->
   <meta name="mobile-web-app-capable" content="yes">

tools/stac-vscode/README.md

@@ -7,7 +7,7 @@ Build and preview Server-Driven UI screens with the **Stac** framework — direc
 ### 🔴 Live Preview
 Open a side-by-side preview of any `@StacScreen` — updates on save, supports theme selection, and renders with Android/iOS/Web platform simulation.
 
-![Stac Live Preview](https://raw.githubusercontent.com/StacDev/stac/dev/tools/stac-vscode/media/stac_preview.png)
+![Stac Live Preview](https://raw.githubusercontent.com/StacDev/stac/main/tools/stac-vscode/media/stac_preview.png)
 
 
 - **`Stac: Open Preview`** — launch the preview panel for the active screen