From 30f4a086ece1019a980f886bfeaaf32cbcd6bf97 Mon Sep 17 00:00:00 2001 From: sasaco Date: Sun, 7 Jan 2024 23:14:31 +0900 Subject: [PATCH] readme --- README.md | 43 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 43 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 00000000..2fd1f3d6 --- /dev/null +++ b/README.md @@ -0,0 +1,43 @@ +

+ TOC + | + documentation + | + demo + | + community + | + npm package +

+ +![cover](cover.png) + +

Open BIM app templates

+ +[![NPM Package][npm]][npm-url] +[![NPM Package][npm-downloads]][npm-url] +[![Tests](https://github.com/IFCjs/components/actions/workflows/tests.yml/badge.svg)](https://github.com/IFCjs/components/actions/workflows/tests.yaml) + +This repository is a CLI command that allow to quickly start your next BIM application using [OpenBIM Components](https://github.com/IFCjs/components) and [Vite](https://vitejs.dev/). + +### Usage + +Starting is really easy, just follow these steps: + +* Install it globally with `npm i -g openbim-app-templates`. +* Create a folder anywhere you want and open it within your IDE. +* In the terminal of the opened folder, run `create-openbim-app` and follow the prompts. +* Run `npm i` and then `npm run dev` +* Go to the localhost provided by Vite and enjoy. + +## Templates +Currently, there are two templates available: + +* Vanilla +* React + +Templates are using TypeScript as OpenBIM Components is written with it, so you can get typing help when developing your app. Keep in mind the templates are not full apps as they lack many of the functionalities from the library, but you can take them as a nice starting point to not going from the scratch. + +[npm]: https://img.shields.io/npm/v/openbim-app-templates +[npm-url]: https://www.npmjs.com/package/openbim-app-templates +[npm-downloads]: https://img.shields.io/npm/dw/openbim-app-templates