Modrinth/README.md
2022-06-21 00:38:52 -07:00

1.4 KiB

Omorphia

The Modrinth component library, in Svelte


Read the documentation at omorphia.modrinth.com.

Developing

The library lives in the src/ folder, and the documentation lives in the docs/ folder.

Getting started

Install Node (16.5+) and PNPM prior to developing.

To start the dev server, install dependencies and run pnpm dev:

pnpm install # Install dependencies
pnpm dev # Run dev server

To use the git hooks in the repo, which will save you waiting for CI to tell you that you forgot to lint, run this:

git config core.hookspath .githooks

Adding new components

Replace ComponentName with your component name in the steps below

  1. Create a ComponentName.svelte file in src/components

  2. Add an export for your component in ./src/index.ts

    export { default as ComponentName } from './components/ComponentName.svelte'
    
  3. Create a ComponentName.md file for documentation in docs/routes/components

  4. Add an example of your component in your ComponentName.md file, like so:

    ```svelte example raised
    <script lang="ts">
    	import { ComponentName } from 'omorphia'
    </script>
    
    <ComponentName />
    ```
    

Building

To build the documentation site, run:

pnpm build