Skip to content

dazzlingxrpl/dazzling-designs

Repository files navigation

🌟 Dazzling Designs

A beautiful collection of animated React components and design elements built with TypeScript. Perfect for adding stunning visual elements to your web applications.

Inspired by xamini.io - Bringing beautiful designs to the open source community ✨

🌍 Our Mission

Dazzling Designs was born from a passion to make beautiful, professional design components accessible to every developer, completely free. Inspired by the stunning work at xamini.io, we believe that great design should be available to everyone, regardless of budget or resources.

We're building a community-driven library where developers can:

  • 🎨 Access beautiful, production-ready components for free
  • 🀝 Contribute their own designs to help others
  • 🌟 Inspire and be inspired by the community
  • πŸš€ Build amazing applications without design constraints

πŸ’ Why Free?

Because we believe in the power of collaboration and community. When developers share their designs, everyone wins. Your next project could inspire someone else's breakthrough, and their contribution might be exactly what you need for your next feature.

Together, we're stronger than any individual designer or company.

✨ Features

  • 🎨 Beautiful Animations: Smooth, eye-catching animations that enhance user experience
  • 🎯 TypeScript Support: Full TypeScript support for better development experience
  • πŸ“± Responsive Design: Mobile-first approach with scalable components
  • 🎨 Multiple Color Schemes: Pre-built color palettes for different themes
  • πŸ“š Storybook Integration: Interactive documentation and component playground
  • πŸš€ Production Ready: Optimized builds with Rollup bundling

🧩 Components

NetworkNodes

An animated network visualization component with floating nodes and connection lines.

import { NetworkNodes } from 'dazzling-designs';

<NetworkNodes 
  size={500} 
  palette="ocean" 
/>

Props:

  • size: Component size in pixels (default: 500)
  • palette: Color scheme ('default', 'dark', 'light', 'ocean', 'sunset', 'forest')
  • className: Custom CSS class
  • style: Custom inline styles

PC

A beautiful PC visualization component that displays content in a browser-like interface.

import { PC } from 'dazzling-designs';

<PC 
  size={500} 
  palette="dark"
  showDefaultContent={true}
>
  {/* Custom content here */}
</PC>

Props:

  • size: Component size in pixels (280-800, default: 320)
  • palette: Color scheme ('default', 'dark', 'light', 'ocean', 'sunset', 'forest')
  • showDefaultContent: Show built-in code example (default: true)
  • children: Custom content to display in the browser window
  • className: Custom CSS class
  • style: Custom inline styles

πŸš€ Quick Start

Installation

npm install dazzling-designs

Basic Usage

import React from 'react';
import { NetworkNodes, PC } from 'dazzling-designs';

function App() {
  return (
    <div>
      <h1>My Awesome App</h1>
      
      {/* Network visualization */}
      <NetworkNodes size={400} palette="ocean" />
      
      {/* PC with custom content */}
      <PC size={500} palette="dark" showDefaultContent={false}>
        <div>Hello, World! 🌍</div>
      </PC>
    </div>
  );
}

🎨 Color Schemes

NetworkNodes

  • default: Modern blue and green theme
  • dark: Dark mode with white accents
  • light: Light mode with dark accents
  • ocean: Deep ocean blues
  • sunset: Warm reds, oranges, and yellows
  • forest: Natural greens and browns

PC

  • default: Classic black and white
  • dark: White PC with dark accents
  • light: Black PC with light accents
  • ocean: Deep blue ocean theme
  • sunset: Warm sunset colors
  • forest: Natural forest theme

πŸ› οΈ Development

Prerequisites

  • Node.js 18+
  • npm or yarn

Setup

# Clone the repository
git clone https://github.com/yourusername/dazzling-designs.git
cd dazzling-designs

# Install dependencies
npm install

# Start development server
npm run storybook

# Build the library
npm run build

# Run tests
npm test

Project Structure

dazzling-designs/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ NetworkNodes/
β”‚   β”‚   β”‚   β”œβ”€β”€ NetworkNodes.tsx
β”‚   β”‚   β”‚   β”œβ”€β”€ NetworkNodes.css
β”‚   β”‚   β”‚   β”œβ”€β”€ NetworkNodes.stories.tsx
β”‚   β”‚   β”‚   └── colorSchemes.ts
β”‚   β”‚   └── PC/
β”‚   β”‚       β”œβ”€β”€ PC.tsx
β”‚   β”‚       β”œβ”€β”€ PC.css
β”‚   β”‚       β”œβ”€β”€ PC.stories.tsx
β”‚   β”‚       └── colorSchemes.ts
β”‚   β”œβ”€β”€ types/
β”‚   └── index.ts
β”œβ”€β”€ storybook-static/
β”œβ”€β”€ dist/
└── package.json

πŸ“š Storybook

View all components and their variations in our interactive Storybook:

npm run storybook

Visit http://localhost:6006 to explore components, test different props, and see live examples.

πŸš€ Deployment

Digital Ocean App Platform

  1. Connect Repository: Link your GitHub repository to Digital Ocean App Platform
  2. Build Command: npm run deploy
  3. Run Command: nginx -g 'daemon off;'
  4. Output Directory: /usr/share/nginx/html

Docker Deployment

# Build the image
docker build -t dazzling-designs .

# Run the container
docker run -p 8080:80 dazzling-designs

Manual Deployment

# Build for production
npm run deploy

# Deploy dist/ and storybook-static/ to your web server

🀝 Contributing

We believe every developer has something beautiful to share! Whether you're a design expert or just getting started, your contributions make this library better for everyone.

🎨 What You Can Contribute

  • New Components: Share your unique design creations
  • Color Schemes: Add new themes and palettes
  • Animations: Create smooth, engaging interactions
  • Documentation: Help others understand and use the library
  • Bug Fixes: Improve reliability and performance
  • Ideas: Suggest new features or improvements

πŸš€ How to Contribute

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Design your component with love and attention to detail
  4. Test thoroughly to ensure it works for everyone
  5. Document your creation with clear examples
  6. Commit your changes (git commit -m 'Add amazing feature')
  7. Push to the branch (git push origin feature/amazing-feature)
  8. Open a Pull Request and share your story!

πŸ’‘ Development Guidelines

  • Design with Heart: Create components you'd be proud to use
  • Think of Others: Ensure your designs are accessible and responsive
  • Follow Standards: Use TypeScript best practices and existing patterns
  • Test Everything: Add comprehensive tests and Storybook stories
  • Document Clearly: Help others understand and use your creation

🌟 Community Guidelines

  • Be Kind: Respect and encourage fellow contributors
  • Share Knowledge: Help others learn and grow
  • Celebrate Success: Recognize and appreciate great contributions
  • Stay Inspired: Draw inspiration from the community around you

πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

🌟 Community & Inspiration

πŸ’« The Power of Open Source

Every component in this library represents someone's creativity, passion, and willingness to share. When you use Dazzling Designs, you're not just getting beautiful componentsβ€”you're becoming part of a movement that believes great design should be accessible to everyone.

🀝 Join the Movement

We're building more than a component libraryβ€”we're building a community of creators who believe in:

  • Collaboration over competition: When we work together, everyone wins
  • Sharing over hoarding: Your designs can inspire thousands of developers
  • Community over individualism: We're stronger together than apart
  • Creativity over constraints: Break free from design limitations

🎨 Your Story Matters

Every contributor has a story. Maybe you're:

  • A designer who wants to give back to the developer community
  • A developer who discovered a beautiful way to solve a problem
  • Someone who believes great design shouldn't cost money
  • A creator who wants to inspire others

Whatever your story, we want to hear it. Share your designs, share your journey, and help us build something amazing together.

πŸ™ Acknowledgments

  • Inspired by: xamini.io - Thank you for showing us what's possible
  • Built with: React - The foundation of our components
  • Styled with: CSS - Bringing beauty to life
  • Bundled with: Rollup - Making it all work together
  • Documented with: Storybook - Sharing our creations
  • Tested with: Jest - Ensuring quality for everyone

πŸ“ž Support


🌟 Ready to Create Something Amazing?

You have the power to make the web more beautiful. Every component you create, every design you share, every contribution you makeβ€”it all adds up to something incredible.

πŸš€ Get Started Today

  1. Install the library: npm install dazzling-designs
  2. Explore the components: Check out our Storybook
  3. Create something beautiful: Use our components in your projects
  4. Share your designs: Contribute back to the community
  5. Inspire others: Show the world what's possible

πŸ’« Remember

Great design shouldn't be locked behind paywalls or company walls. It should be free, accessible, and available to every developer who wants to create something beautiful.

Together, we're building a future where amazing design is available to everyone. Join us in making the web a more beautiful, more inspiring place.


Made with ❀️ by the Dazzling Designs team and inspired by the amazing work at xamini.io

Let's create something dazzling together! ✨

About

Dazzling Designs for you

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published