fulldev-ui 0.7.0-beta.9 → 0.7.0

package/.editorconfig

@@ -0,0 +1,10 @@
+# editorconfig.org
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_size = 2
+indent_style = space
+insert_final_newline = true
+trim_trailing_whitespace = true

package/.github/CODEOWNERS

@@ -0,0 +1,2 @@
+# Make silveltman code owners for the entire repository
+* @silveltman

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,12 @@
+name: "Bug report"
+description: Report a bug or issue
+labels: ["bug"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the bug or issue
+      description: Be clear and concise. Add logs and/or screenshots if applicable.
+      placeholder: Add your bug or issue description here...
+    validations:
+      required: true

package/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_buttons:
+  - name: Add your site to our showcase
+    url: https://github.com/fulldotdev/ui/blob/main/CONTRIBUTING.md#showcase
+    about: Add your project to the showcase page and get featured on our website.
+  - name: Get Help on Discord
+    url: https://discord.gg/tdmUyH2YE4
+    about: If you can't get something to work, open a forum post in our Discord server.

package/.github/ISSUE_TEMPLATE/documentation.yml

@@ -0,0 +1,12 @@
+name: "Documentation"
+description: Issues and suggestions regarding documentation
+labels: ["docs"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the issue or suggestion
+      description: Be clear and concise. Add logs and/or screenshots if applicable.
+      placeholder: Add your issue or suggestion description here...
+    validations:
+      required: true

package/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,12 @@
+name: "Feature"
+description: Propose and discuss improvements
+labels: ["feature"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe the feature
+      description: Be clear and concise. Add logs and/or screenshots if applicable.
+      placeholder: Add your feature description here...
+    validations:
+      required: true

package/.github/ISSUE_TEMPLATE/support.yml

@@ -0,0 +1,12 @@
+name: "Support"
+description: Ask a question or request help
+labels: ["support"]
+body:
+  - type: textarea
+    id: description
+    attributes:
+      label: Describe your question or request
+      description: Be clear and concise. Add logs and/or screenshots if applicable.
+      placeholder: Add your question or request description here...
+    validations:
+      required: true

package/.nvmrc

@@ -0,0 +1 @@
+v20.5.1

package/.prettierignore

@@ -0,0 +1,21 @@
+# folders
+.astro/
+.netlify/
+dist/
+.stackbit/
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+# Lock files
+pnpm-lock.yaml
+package-lock.json
+yarn.lock
+bun.lockb
+
+# misc
+**/.DS_Store

package/CHANGELOG.md

@@ -1,4 +1,3 @@
 # Changelog
 
 ## [Click here to the releases](https://github.com/fulldotdev/ui/releases)
-

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,7 @@
+# Contributor Code of Conduct
+
+We accept and encourage everyone's contributions. It doesn't matter how you look, how you feel, where you're from, or anything like that. In fact, we won't bring it up, or ask.
+
+We are here to build great software, to learn, to grow, and to help each other. Maybe make some friends along the way.
+
+If you have any questions, please reach out!

package/CONTRIBUTING.md

@@ -0,0 +1,142 @@
+# Contributing to Fulldev UI
+
+Thank you for your interest in contributing to Fulldev UI! We welcome contributions from everyone.
+
+## Code of Conduct
+
+We are here to build great software, learn, grow, and help each other. Please read our [Code of Conduct](CODE_OF_CONDUCT.md) before contributing.
+
+## Getting Started
+
+### Prerequisites
+
+- Node.js 18 or higher
+- pnpm (recommended package manager)
+- Git
+
+### Setup
+
+1. **Fork and clone the repository**:
+
+```bash
+git clone https://github.com/your-username/ui.git
+cd ui
+```
+
+2. **Install dependencies**:
+
+```bash
+pnpm install
+```
+
+3. **Start the development server**:
+
+```bash
+pnpm dev
+```
+
+## How to Contribute
+
+### Reporting Bugs
+
+1. Check if the bug has already been reported in [Issues](https://github.com/fulldotdev/ui/issues)
+2. If not, create a new issue using the bug report template
+3. Provide clear steps to reproduce the issue
+4. Include screenshots or code snippets if applicable
+
+### Requesting Features
+
+1. Check if the feature has already been requested in [Issues](https://github.com/fulldotdev/ui/issues)
+2. Create a new issue using the feature request template
+3. Clearly describe the feature and its use case
+
+### Submitting Code
+
+1. **Create a new branch**:
+
+```bash
+git checkout -b feature/your-feature-name
+```
+
+2. **Make your changes**:
+   - Follow existing code style and conventions
+   - Use TypeScript for type safety
+   - Follow Astro component best practices
+   - Ensure components follow the shared schema in `src/lib/schemas.ts`
+
+3. **Test your changes**:
+
+```bash
+pnpm check    # Type checking
+pnpm build    # Build the project
+```
+
+4. **Commit your changes**:
+
+```bash
+git commit -m "feat: add new component"
+```
+
+5. **Push and create a Pull Request**:
+
+```bash
+git push origin feature/your-feature-name
+```
+
+Then create a PR on GitHub with a clear description of your changes.
+
+## Component Guidelines
+
+### Creating New Components
+
+1. Place component files in `src/components/ui/[component-name]/`
+2. Follow the naming convention: use single-word names when possible
+3. Use Astro component syntax (`.astro` files)
+4. Include TypeScript types for props
+5. Use Tailwind CSS for styling with primary/secondary color variables
+6. Avoid modifying existing shadcn components to prevent confusion
+
+### Example Component Structure
+
+```astro
+---
+interface Props {
+  title?: string
+  variant?: "default" | "outline"
+}
+
+const { title, variant = "default" } = Astro.props
+
+const slot = await Astro.slots.render("default")
+---
+
+<div class="component-name">
+  {title && <h2>{title}</h2>}
+  <Fragment set:html={slot} />
+</div>
+```
+
+## Development Workflow
+
+### Building
+
+```bash
+pnpm build          # Build the project
+pnpm build:prod     # Type check + build
+pnpm build:test     # Type check + build + preview
+```
+
+### Registry
+
+```bash
+pnpm registry:build    # Build the component registry
+```
+
+## Questions?
+
+- Join our [Discord server](https://discord.gg/tdmUyH2YE4)
+- Reach out via [email](mailto:contact@full.dev)
+
+## License
+
+By contributing to fulldev/ui, you agree that your contributions will be licensed under the MIT License.

package/README.md

@@ -1,33 +1,105 @@
 # Fulldev UI
 
-The [Astro][astro] UI library to build entire websites
+A shadcn-compatible component library built for [Astro][astro], designed for content-driven websites.
 
-Make websites with prebuilt components and blocks
+## Features
+
+- **Vanilla Astro Components** — No framework dependencies, pure Astro components
+- **shadcn Compatible** — Uses the shadcn CLI and registry system for easy installation
+- **Content-First** — Built for content-driven websites with components like sections and tiles
+- **100+ Components & Blocks** — Ready-to-use UI components and pre-built page blocks
+- **Tailwind CSS v4** — Styled with the latest Tailwind CSS
+- **TypeScript** — Full TypeScript support
+
+## Installation
+
+### Prerequisites
+
+- Node.js 18+
+- pnpm (recommended) or npm
+
+### Quick Start
+
+1. **Create a new Astro project** (skip if you have one):
+
+```bash
+npx create-astro@latest my-project --template with-tailwindcss --install --git
+cd my-project
+```
+
+2. **Configure TypeScript paths** in `tsconfig.json`:
+
+```json
+{
+  "compilerOptions": {
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  }
+}
+```
+
+3. **Initialize shadcn**:
+
+```bash
+npx shadcn@latest init
+```
+
+4. **Add fulldev/ui registry** to `components.json`:
+
+```json
+{
+  "registries": {
+    "@fulldev": "https://ui.full.dev/r/{name}.json"
+  }
+}
+```
+
+5. **Add components**:
+
+```bash
+npx shadcn@latest add @fulldev/button
+```
 
 ## Documentation
 
-Please visit the [documentation site][docs]
+Visit [ui.full.dev][docs] for complete documentation, component examples, and usage guides.
 
-## Contributing
+## Development
 
-We welcome all contributions. Please checkout the repository to get started, it is structured just like a normal Astro project.
+```bash
+# Install dependencies
+pnpm install
 
-## Support
+# Start development server
+pnpm dev
 
-Please [create a Github issue][issues] for things that cross your mind; feature requests, bug reports or feedback.
+# Build for production
+pnpm build
 
-## Community / Contact
+# Preview production build
+pnpm preview
 
-Looking to share your work using fulldev-ui, regular talks about it or support join our [discord server](https://discord.gg/tdmUyH2YE4).
+# Type check
+pnpm check
+```
 
-## License
+## Contributing
+
+We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## Community
 
-MIT
+- **Discord** — Join our [Discord server][discord] to share your work and get support
+- **Issues** — Report bugs and request features on [GitHub Issues][issues]
+
+## License
 
-Copyright (c) 2024–present [Fulldev][fulldev]
+MIT License — Copyright (c) 2024–present [Fulldev][fulldev]
 
 [astro]: https://astro.build/
 [docs]: https://ui.full.dev/
 [fulldev]: https://full.dev/
-[issues]: https://github.com/fulldotdev/ui/issues/
-[discord]: https://discord.gg/vXZqMbadm8
+[issues]: https://github.com/fulldotdev/ui/issues
+[discord]: https://discord.gg/tdmUyH2YE4

package/ai/website-quality-checklist.md

@@ -0,0 +1,33 @@
+# Website Quality Checklist
+
+If you're an AI, run this checklist **without scripts/commands/CLI** except when it is explicitly stated. Also don't generate a report file, just fix the issues.
+
+## Automated Tests
+
+Run the following commands to check for errors:
+
+- [ ] `pnpm check` - no errors
+- [ ] `pnpm build` - no errors
+
+## Content
+
+Look at all files in src/content/ and check for:
+
+- [ ] No placeholder text (dots, TODOs, temp text)
+- [ ] No empty headers
+- [ ] No trailing whitespace
+- [ ] No spelling/grammar errors
+- [ ] All page titles approximately 50-60 characters
+- [ ] All page descriptions approximately 150-160 characters
+- [ ] All image paths are relative (not absolute)
+- [ ] All images have descriptive alt text
+
+## Links
+
+Run `pnpm dev`, open the website in the browser on the port logged after the dev command. Based on src/content/pages/\*\* you should be able to navigate to all pages and check for:
+
+- [ ] No broken links
+- [ ] Website is responsive
+- [ ] No errors or logs in console
+- [ ] No missing images
+- [ ] No weird layout issues

package/astro.config.example.ts

@@ -0,0 +1,90 @@
+import sitemap from "@astrojs/sitemap"
+import tailwindcss from "@tailwindcss/vite"
+import favicons from "astro-favicons"
+import robotsTxt from "astro-robots-txt"
+import { defineConfig, fontProviders } from "astro/config"
+
+import site from "./site.json"
+
+export default defineConfig({
+  site: site.site,
+  image: {
+    breakpoints: [640, 750, 828, 1080, 1280, 1668, 2048, 2560],
+    responsiveStyles: false,
+    layout: "full-width",
+  },
+  prefetch: {
+    prefetchAll: true,
+  },
+  devToolbar: {
+    enabled: false,
+  },
+  i18n: {
+    defaultLocale: site.defaultLocale,
+    locales: site.locales,
+    routing: {
+      prefixDefaultLocale: false,
+      redirectToDefaultLocale: false,
+      fallbackType: "redirect",
+    },
+  },
+  experimental: {
+    fonts: [
+      {
+        provider: fontProviders.google(),
+        cssVariable: "--font-base",
+        name: site.fonts.base,
+        weights: [
+          "100",
+          "200",
+          "300",
+          "400",
+          "500",
+          "600",
+          "700",
+          "800",
+          "900",
+        ],
+      },
+      {
+        provider: fontProviders.google(),
+        cssVariable: "--font-heading",
+        name: site.fonts.heading || site.fonts.base,
+        weights: [
+          "100",
+          "200",
+          "300",
+          "400",
+          "500",
+          "600",
+          "700",
+          "800",
+          "900",
+        ],
+      },
+    ],
+  },
+  vite: {
+    plugins: [tailwindcss()],
+  },
+  integrations: [
+    robotsTxt(),
+    sitemap({
+      changefreq: "weekly",
+      lastmod: new Date(),
+      i18n: {
+        defaultLocale: site.defaultLocale,
+        locales: Object.fromEntries(
+          site.locales.map((locale) => [locale, locale])
+        ),
+      },
+    }),
+    favicons({
+      input: {
+        favicons: [site.favicon],
+      },
+      name: site.name,
+      short_name: site.name,
+    }),
+  ],
+})

package/astro.config.ts

@@ -0,0 +1,183 @@
+import mdx from "@astrojs/mdx"
+import sitemap from "@astrojs/sitemap"
+import starlight from "@astrojs/starlight"
+import tailwindcss from "@tailwindcss/vite"
+import favicons from "astro-favicons"
+import liveCode from "astro-live-code"
+import robotsTxt from "astro-robots-txt"
+import { defineConfig, fontProviders } from "astro/config"
+
+import site from "./site.json"
+
+export default defineConfig({
+  site: site.site,
+  image: {
+    breakpoints: [640, 750, 828, 1080, 1280, 1668, 2048, 2560],
+    layout: "full-width",
+    responsiveStyles: false,
+  },
+  prefetch: {
+    prefetchAll: true,
+  },
+  devToolbar: {
+    enabled: false,
+  },
+  i18n: {
+    defaultLocale: site.defaultLocale,
+    locales: site.locales,
+    routing: {
+      prefixDefaultLocale: false,
+      redirectToDefaultLocale: false,
+      fallbackType: "redirect",
+    },
+  },
+  redirects: {
+    // components
+    "/docs/customization": "/docs/theming/",
+    "/docs/framworks": "/docs/introduction/",
+    "/docs/structures": "/docs/section/",
+    "/docs/components/badges": "/docs/components/badge/",
+    "/docs/components/channel": "/docs/components/item/",
+    "/docs/components/channels": "/docs/components/item/",
+    "/docs/components/heading": "/docs/components/section/",
+    "/docs/components/link": "/docs/components/button/",
+    "/docs/components/links": "/docs/components/button/",
+    "/docs/components/menus": "/docs/components/navigation-menu/",
+    "/docs/components/paragraph": "/docs/components/section/",
+    "/docs/components/social": "/docs/components/button/",
+    "/docs/components/socials": "/docs/components/button/",
+    "/docs/components/switch": "/docs/components/",
+    "/docs/components/tagline": "/docs/components/section/",
+
+    // structures
+    "/docs/structures/card": "/docs/components/tile/",
+    "/docs/structures/carousel": "/docs/components/native-carousel/",
+    "/docs/structures/code": "/docs/components/",
+    "/docs/structures/container": "/docs/components/section/",
+    "/docs/structures/drawer": "/docs/components/sheet/",
+    "/docs/structures/group": "/docs/components/section/",
+    "/docs/structures/layout": "/docs/components/section/",
+    "/docs/structures/masonry": "/docs/components/section/",
+    "/docs/structures/matrix": "/docs/components/section/",
+    "/docs/structures/panel": "/docs/components/section/",
+    "/docs/structures/prose": "/docs/components/section/",
+    "/docs/structures/section": "/docs/components/section/",
+    "/docs/structures/sidebar": "/docs/components/",
+    "/docs/structures/split": "/docs/components/section/",
+    "/docs/structures/stack": "/docs/components/section/",
+
+    // blocks
+    "/docs/blocks/banner": "/blocks/banner/",
+    "/docs/blocks/colleagues": "/blocks/",
+    "/docs/blocks/content": "/blocks/content/",
+    "/docs/blocks/cta": "/blocks/cta/",
+    "/docs/blocks/features": "/blocks/features/",
+    "/docs/blocks/footer": "/blocks/footer/",
+    "/docs/blocks/header": "/blocks/header/",
+    "/docs/blocks/hero": "/blocks/hero/",
+    "/docs/blocks/intro": "/blocks/hero/",
+    "/docs/blocks/logos": "/blocks/logos/",
+    "/docs/blocks/reviews": "/blocks/reviews/",
+    "/docs/blocks/projects": "/blocks/services/",
+  },
+  experimental: {
+    fonts: [
+      {
+        provider: fontProviders.google(),
+        cssVariable: "--font-base",
+        name: site.fonts.base,
+        weights: [
+          "100",
+          "200",
+          "300",
+          "400",
+          "500",
+          "600",
+          "700",
+          "800",
+          "900",
+        ],
+      },
+      {
+        provider: fontProviders.google(),
+        cssVariable: "--font-heading",
+        name: site.fonts.heading || site.fonts.base,
+        weights: [
+          "100",
+          "200",
+          "300",
+          "400",
+          "500",
+          "600",
+          "700",
+          "800",
+          "900",
+        ],
+      },
+    ],
+  },
+  vite: {
+    plugins: [tailwindcss()],
+  },
+  integrations: [
+    robotsTxt(),
+    sitemap({
+      changefreq: "weekly",
+      lastmod: new Date(),
+      i18n: {
+        defaultLocale: site.defaultLocale,
+        locales: Object.fromEntries(
+          site.locales.map((locale) => [locale, locale])
+        ),
+      },
+    }),
+    favicons({
+      input: {
+        favicons: [site.favicon],
+      },
+      name: site.name,
+      short_name: site.name,
+    }),
+    starlight({
+      title: site.name,
+      description:
+        "The Astro UI component and block library for content-driven websites.",
+      sidebar: [
+        {
+          label: "Get started",
+          items: [
+            "docs",
+            "docs/installation",
+            "docs/theming",
+            {
+              label: "Blocks",
+              link: "/blocks/",
+            },
+          ],
+        },
+        {
+          label: "Components",
+          autogenerate: { directory: "docs/components" },
+        },
+      ],
+      customCss: [
+        "./src/styles/global.css",
+        "@fontsource/inter/400.css",
+        "@fontsource/inter/500.css",
+        "@fontsource/inter/600.css",
+        "@fontsource/inter/700.css",
+        "@fontsource/inter/800.css",
+      ],
+      components: {
+        SiteTitle: "/src/components/starlight-title.astro",
+        ThemeSelect: "/src/components/starlight-icons.astro",
+        MarkdownContent: "/src/components/starlight-markdown-content.astro",
+        ThemeProvider: "/src/components/ui/theme-toggle/theme-provider.astro",
+      },
+    }),
+    liveCode({
+      layout: "/src/components/live-code-layout.astro",
+    }),
+    mdx(),
+  ],
+})