docs(tw4): migration docs

sites/docs/src/content/changelog.md

@@ -7,6 +7,26 @@ description: Latest updates and announcements.
 	import { Steps, Callout, ComponentPreview } from '$lib/components/docs'
 </script>
 
+## May 2025
+
+### Tailwind v4 Support
+
+Tailwind v4 support has officially landed. You can see a full demo of the refreshed styles that come with it here: [https://v4.shadcn-svelte.com](https://v4.shadcn-svelte.com).
+
+This release includes several key changes, all outlined in the [Tailwind v4 migration guide](/docs/migration/tailwind-v4). If you're still using Svelte v5 with Tailwind v3, your project and the CLI will continue to work as expected until you're ready to upgrade.
+
+### Charts
+
+Charts have been added as a preview component to the project. See the [Charts](/charts) page for examples.
+
+If you're running Svelte v5 and Tailwind v4 you can add them to your project via the CLI.
+
+### Custom Registry Support
+
+We've added support for custom/remote registries - This means you can publish your own components and share them with the community via the `shadcn-svelte` CLI.
+
+See the [Registry documentation](/docs/registry) for more information.
+
 ## March 2024
 
 ### Introducing Blocks

sites/docs/src/content/components-json.md

@@ -35,6 +35,8 @@ You can see the JSON Schema for `components.json` [here](https://next.shadcn-sve
 
 ## style
 
+_Deprecated in Tailwind v4 as all projects use `new-york`_
+
 The style for your components. **This cannot be changed after initialization.**
 
 ```json title="components.json"
@@ -85,6 +87,18 @@ The CLI uses these values and the `alias` config from your `svelte.config.js` fi
 
 Path aliases have to be set up in your `svelte.config.js` file.
 
+### aliases.lib
+
+Import alias for your library, which is _typically_ where you store your components, utils, hooks, etc.
+
+```json title="components.json"
+{
+  "aliases": {
+    "lib": "$lib"
+  }
+}
+```
+
 ### aliases.utils
 
 Import alias for your utility functions.
@@ -109,6 +123,30 @@ Import alias for your components.
 }
 ```
 
+### aliases.ui
+
+Import alias for your UI components.
+
+```json title="components.json"
+{
+  "aliases": {
+    "ui": "$lib/components/ui"
+  }
+}
+```
+
+### aliases.hooks
+
+Import alias for your hooks, which in Svelte 5 are reactive functions/classes whose files typically end in `.svelte.ts` or `.svelte.js`.
+
+```json title="components.json"
+{
+  "aliases": {
+    "hooks": "$lib/hooks"
+  }
+}
+```
+
 ## Typescript
 
 ```json title="components.json"
@@ -119,7 +157,7 @@ Import alias for your components.
 
 ## Registry
 
-The registry URL tells the CLI where to fetch the components/registry from. You can pin this to a specific preview release or your own fork.
+The registry URL tells the CLI where to fetch the shadcn-svelte components/registry from. You can pin this to a specific preview release or your own fork of the registry.
 
 ```json title="components.json"
 {