Skip to content

Your go-to design library crafted to elevate your creative journey

License

Notifications You must be signed in to change notification settings

Mockline/mockline

Repository files navigation

Mockline Social Preview

Welcome to Mockline, your go-to design library crafted to elevate your creative journey. Whether you're a seasoned designer or a budding developer, Mockline is designed to empower you with efficient, innovative, and collaborative tools, putting the joy back into the design process.

Getting Started

Visit mockline.dev to get started with Mockline.

Features

  • Everything you need: Mockline is a design system that provides everything you need to create stunning designs, from buttons to modals, toasts, tooltips, and more.
    • Icons provided by Nuxt Icon, U can use any icon from Lucide, Heroicons, etc...
    • TailwindCSS is directly integrated, so you can use all the power of TailwindCSS with zero configuration.
    • Toasts are also provided by Vue Sonner, so you can easily create beautiful toasts with ease.
    • Themes are provided by Color Mode, so you can easily switch between light and dark modes or even create your own themes.
    • Nuxt Content is also integrated and can be activated by setting content: true in the mockline module options.
  • Fully customizable: All components are customizable via props and slots.
  • Dark mode: Enjoy a seamless dark mode experience with no additional setup.
  • Responsive: Components are designed to be responsive across all devices.
  • Easy to use: Mockline is designed to be beginner-friendly, with a simple setup process.
  • Community-driven: Join the Mockline community on Discord to connect with other users and share your feedback.
  • Open-source: Mockline is open-source, and we welcome contributions from the community.

Quick Setup

For the moment Mockline is only available for Nuxt projects (Vue 3 support and react support will be added soon). To get started, follow these steps:

Quickly add Mockline to your Nuxt project using the following command:

npx nuxi@latest module add mockline

It will automatically install and set up the Mockline module in your nuxt.config.ts file.

or

  1. Add mockline dependency to your project
# Using bun
bun install -D mockline

# Using pnpm
pnpm add -D mockline

# Using yarn
yarn add --dev mockline

# Using npm
npm install --save-dev mockline
  1. Add mockline to the modules section of nuxt.config.ts
export default defineNuxtConfig({
  modules: [
    'mockline'
  ]
})

That's it! You can now use Mockline in your Nuxt app ✨

Community

The Mockline community can be found on Discord, to chat with other community members, you can join the Mockline Discord.

Roadmap

Roadmap
  • Overlays
    • Toast
    • Modal
    • Tooltip
    • Popover
    • Slideover
  • Components
    • Button
    • Icon
    • Input
    • Checkbox
    • Radio
    • Switch
    • Select
    • Textarea
    • Toggle
    • Range
    • Slider
    • Progress
    • Rating
    • Avatar
    • Badge
    • Card
    • Table
    • Tabs
    • Breadcrumbs
    • Pagination
    • Steps
    • Tree
    • Calendar
    • Datepicker
    • Timepicker
  • Layout
    • Grid
    • Flex
    • Page
    • Sidebar
    • Drawer
  • Documentation
    • NavigationTree
    • Surround
    • Toc
  • Utilities
    • Typography
  • Themes
    • ThemeToggle
    • ThemeSwitch

Contributing

To start contributing, you can follow these steps:

  1. First raise an issue to discuss the changes you would like to make.
  2. Fork the repository.
  3. Create a branch using conventional commits and the issue number as the branch name. For example, feat/123 or fix/456.
  4. Make changes following the local development steps.
  5. Commit your changes following the Conventional Commits specification.
  6. If your changes affect the code, run tests using bun run test.
  7. Create a pull request following the Pull Request Template.
    • To be merged, the pull request must pass the tests/workflow and have at least one approval.
    • If your changes affect the documentation, make sure to update it.
    • If your changes affect the code, make sure to update the tests.
  8. Wait for the maintainers to review your pull request.
  9. Once approved, the pull request will be merged in the next release !
Local development
  • Clone this repository
  • Install latest LTS version of Node.js
  • Enable Corepack using corepack enable
  • Install dependencies using bun install

Published under the APACHE license. Made by @HugoRCD and community 💛


🤖 auto updated with automd (last updated: Tue Oct 08 2024)