@jeetkhinde/stardawn-ui
v1.0.7
Published
StarDawn UI — component installer for Astro + Tailwind MSP template sites
Maintainers
Readme
StarDawn UI
A component registry for Astro + Tailwind CSS sites — inspired by shadcn/ui. Components are copied into your project, not imported from a package. You own the code.
Built for StarDawn IT MSP template sites. Dark theme, gold/purple accents, GSAP animations.
Installation
npx @jeetkhinde/stardawn-ui initThis creates src/styles/global.css with the Tailwind theme and prints all remaining setup steps.
Setup (what init walks you through)
1. Install Tailwind CSS
npm install tailwindcss @tailwindcss/vite2. Update astro.config.mjs
import { defineConfig } from 'astro/config';
import tailwindcss from '@tailwindcss/vite';
export default defineConfig({
vite: {
plugins: [tailwindcss()],
},
});3. Import global.css in your layout
---
import '../styles/global.css';
---4. Add fonts + GSAP to your layout <head>
<!-- Fonts -->
<link rel="preconnect" href="https://fonts.googleapis.com">
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
<link href="https://fonts.googleapis.com/css2?family=DM+Sans:wght@400;500;700&family=Outfit:wght@500;700;900&display=swap" rel="stylesheet">
<!-- GSAP (required by Button, BackgroundGlow, Navbar) -->
<script is:inline src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/gsap.min.js"></script>
<script is:inline src="https://cdnjs.cloudflare.com/ajax/libs/gsap/3.12.5/ScrollTrigger.min.js"></script>Adding Components
# See all available components
npx @jeetkhinde/stardawn-ui list
# Add a component (dependencies are installed automatically)
npx @jeetkhinde/stardawn-ui add button
npx @jeetkhinde/stardawn-ui add navbar footer
npx @jeetkhinde/stardawn-ui add navbar footer bento-card section-headerComponents are written to src/components/ by default.
# Custom output directory
npx @jeetkhinde/stardawn-ui add button --output src/components/uiAvailable Components
| Component | Category | Description |
|---|---|---|
| button | ui | Primary/secondary button with GSAP magnetic effect |
| pill-tag | ui | Pill-shaped tag, optionally a link |
| status-badge | ui | Animated pulsing status badge |
| section-header | ui | Section heading with eyebrow, gradient title, description |
| background-glow | ui | Parallax radial glow orbs (mouse-follow via GSAP) |
| offset-card | ui | Dark card with offset hover shadow, yellow/blue accent |
| bento-card | ui | Bento-style card with icon, title, and slot |
| feature-list-item | ui | Feature item in four variants: list, bento, detail, simple |
| footer-link | navigation | Animated footer nav link with sliding chevron |
| navbar | navigation | Sticky navbar with mega-menu and GSAP animations |
| footer | navigation | Full-width footer with CTA strip and nav columns |
| side-nav | navigation | Fixed left sidebar for portal/dashboard layouts |
| service-hero | sections | Full-width hero for service pages with badge + CTA |
Design System
Fonts
font-display— Outfit (headings, labels, uppercase text)font-sans— DM Sans (body text, nav links)
Brand Colors
- Gold:
#ffe792 - Purple:
#8197ff - Background:
#0e0e0e
Animations
- GSAP 3 + ScrollTrigger for scroll animations
- Components check
window.gsap— load GSAP globally via CDN before using animated components
How It Works
stardawn-ui is a CLI that reads registry.json and copies .astro component files directly into your project. No runtime dependency. No bundled CSS. No imports. The components use Tailwind utility classes — as long as Tailwind is set up in your project, they work.
This is the same model as shadcn/ui.
Local Development
# Test the CLI against local components (skip npm)
node cli/index.js add button --local .
# Run the sandbox
cd sandbox && npm run dev