Browse Source

Meta: Add usage section to the README

master
Riyyi 4 weeks ago
parent
commit
9604097e7f
  1. 58
      README.org
  2. 3
      package.json

58
README.org

@ -2,25 +2,64 @@
Website, written in Typescript. Website, written in Typescript.
* Usage
** Setup
Install dependencies:
#+BEGIN_SRC sh
$ bun install
#+END_SRC
** Development Server
Start the development server on =http://localhost:3000=:
#+BEGIN_SRC sh
$ bun run dev
$ bun run dev -o # automatically open in the browser
#+END_SRC
** Production
Build for production:
#+BEGIN_SRC sh
$ bun nuxi build # for server-side rendering or hybrid
$ bun nuxi generate # for static site generation
#+END_SRC
Locally preview production build:
#+BEGIN_SRC sh
$ bun run preview # requires building first!
#+END_SRC
Reference: [[https://nuxt.com/docs/getting-started/deployment#client-side-only-rendering][nuxt/docs/deployment#client-side-only-rendering]]
* Libraries * Libraries
- Vue.js 3 - [[https://github.com/vuejs/core][Vue3]] JavaScript framework
- Nuxt - [[https://github.com/nuxt/nuxt][Nuxt]] Vue framework
- Pinia - [[https://github.com/vuejs/pinia][Pinia]] State management
- PrimeVue - [[https://github.com/primefaces/primevue][PrimeVue]] Vue component library
- ESLint - [[https://github.com/colinhacks/zod][Zod]] Schema validation
- [[https://github.com/microsoft/TypeScript][Typescript]] Static types in JavaScript
- [[https://github.com/eslint/eslint][ESLint]] Code analyses tool
* Development ** Package Reproduction
The following editor setup has been used: The following bun commands have been run to fill the =package.json=:
#+BEGIN_SRC sh #+BEGIN_SRC sh
$ bun x nuxi@latest init website $ bun x nuxi@latest init website
# Development
$ bun nuxi module add eslint $ bun nuxi module add eslint
$ bun install --dev typescript $ bun install --dev typescript
$ bun install --dev @vue/language-server $ bun install --dev @vue/language-server
$ bun install --dev @vue/typescript-plugin $ bun install --dev @vue/typescript-plugin
$ bun install -g typescript $ bun install -g typescript
$ bun install -g @vue/language-server $ bun install -g @vue/language-server
$ bun install -g @vue/typescript-plugin $ bun install -g @vue/typescript-plugin
@ -31,4 +70,7 @@ $ bun install pinia
# PrimeVue # PrimeVue
$ bun install primevue primeicons @primevue/themes $ bun install primevue primeicons @primevue/themes
$ bun install --dev @primevue/nuxt-module $ bun install --dev @primevue/nuxt-module
# Zod
$ bun install zod
#+END_SRC #+END_SRC

3
package.json

@ -16,7 +16,8 @@
"primeicons": "^7.0.0", "primeicons": "^7.0.0",
"primevue": "^4.2.3", "primevue": "^4.2.3",
"vue": "latest", "vue": "latest",
"vue-router": "latest" "vue-router": "latest",
"zod": "^3.23.8"
}, },
"devDependencies": { "devDependencies": {
"@nuxt/eslint": "^0.7.1", "@nuxt/eslint": "^0.7.1",

Loading…
Cancel
Save