2022-07-07 02:32:19 +00:00
# Vite RiotJS Template
Use [Vite ](https://vitejs.dev/ ) Starter Template to scaffold a new [Riot ](https://riot.js.org/ ) project.
2022-07-18 04:19:13 +00:00
2022-07-07 02:32:19 +00:00
## Getting Started
Pull the template files with [degit ](https://github.com/Rich-Harris/degit ) and install dependencies
```
npx degit n2geoff/vite-riot-template my-project
cd my-project
npm install
npm run dev
2022-07-07 02:34:10 +00:00
```
2022-07-07 02:32:19 +00:00
2022-07-18 04:19:13 +00:00
### Mounting Strategy
This template uses a **pages** static registry based approach that auto-mounts global *page components* that then can dynaimicly mount other *components* needed build your up your content via the `components` export default property.
> SEE: /pages/registry.js for more information
#### Components Example
```
< my-page >
< div >
< example-component > < / example-component >
< / div >
< script >
import Example from './example-component/example-component.riot';
export default {
components: {
Example
}
}
< / script >
< / my-page >
```
> recommend a dedicated `/components` directory
### Testing
- TODO
> SEE: `pages/hello-riot/hello-riot.spec.js` (unwired)
2022-07-07 02:32:19 +00:00
## NPM Scripts
- npm run dev - Starts the development server at port 3000
- npm run build - Builds the application in a dist folder
- npm run preview - Serves the build files (dist folder) locally at port 5000
> Note that if after this last command you do not see anything, you can use instead this other command:
`npm run preview --host` - You should then be able to see your files locally at port 5000
2022-07-15 23:59:14 +00:00
## Checklist
2022-07-18 03:53:56 +00:00
When you use this template, you should update the following with your information
2022-07-15 23:59:14 +00:00
- [ ] Change the author name in `LICENSE`
- [ ] Change the favicon in `public`
- [ ] Clean up the README
2022-07-18 04:19:13 +00:00
## TODO
- Add Testing Example w/ Chai & Mocha
2022-07-07 02:32:19 +00:00
## License
2022-07-18 03:53:56 +00:00
- [MIT License ](https://github.com/n2geoff/vite-riot-template/blob/main/LICENSE ).