Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/Mockline/mockline
Your go-to design library crafted to elevate your creative journey
https://github.com/Mockline/mockline
components library nuxt typescript ui vue
Last synced: 2 months ago
JSON representation
Your go-to design library crafted to elevate your creative journey
- Host: GitHub
- URL: https://github.com/Mockline/mockline
- Owner: Mockline
- License: apache-2.0
- Created: 2023-12-11T19:09:23.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-11-29T14:29:05.000Z (3 months ago)
- Last Synced: 2024-12-02T18:12:07.791Z (2 months ago)
- Topics: components, library, nuxt, typescript, ui, vue
- Language: TypeScript
- Homepage: https://mockline.dev
- Size: 11.5 MB
- Stars: 10
- Watchers: 1
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: .github/funding.yml
- License: LICENSE
Awesome Lists containing this project
README
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](https://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](https://github.com/nuxt-modules/icon), U can use any icon from [Lucide](https://lucide.dev/), [Heroicons](https://heroicons.com/), etc...
- TailwindCSS is directly integrated, so you can use all the power of TailwindCSS with zero configuration.
- Toasts are also provided by [Vue Sonner](https://github.com/xiaoluoboding/vue-sonner), so you can easily create beautiful toasts with ease.
- Themes are provided by [Color Mode](https://github.com/nuxt-modules/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:
```bash
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
```bash
# 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
```
2. Add `mockline` to the `modules` section of `nuxt.config.ts`
```js
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](https://discord.gg/BkgyMzvJ3p).
## Roadmap
Roadmap
- Overlays
- [x] Toast
- [ ] Modal
- [ ] Tooltip
- [ ] Popover
- [ ] Slideover
- Components
- [x] Button
- [x] 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](https://www.conventionalcommits.org/en/v1.0.0/) specification.
6. If your changes affect the code, run tests using `bun run test`.
7. Create a pull request following the [Pull Request Template](https://github.com/HugoRCD/markdown/blob/main/src/pull_request_template.md).
- 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](https://nodejs.org/en/)
- Enable [Corepack](https://github.com/nodejs/corepack) using `corepack enable`
- Install dependencies using `bun install`
Published under the [APACHE](https://github.com/mockline/mockline/blob/main/LICENSE) license.
Made by [@HugoRCD](https://github.com/HugoRCD) and [community](https://github.com/mockline/mockline/graphs/contributors) 💛
---
_🤖 auto updated with [automd](https://automd.unjs.io) (last updated: Tue Oct 08 2024)_