@nanonpm/photon

photon

Project setup

npm install

Compiles and hot-reloads for development

npm run serve

Compiles and minifies plugin for production

npm run build:lib

Run your unit tests

npm run test:unit

Lints and fixes files

npm run lint

Publishing to npm

Steps for publishing

• Make sure you are logged into the nanonpm npm account.

npm login

• Update the package version in the package.json file under the version field. We are using semantic versioning.

• Update the changelog file with the changes you have made.

• Run the deploy command - this will run 2 commands synchronously: i) npm run build:lib (builds the project) ii) npm publish (published to npm)

npm run deploy

Working in Photon

Creating new components

To create a new component and add to Photon & Storybook run:

npm run new

This will run a script prompting you for:

• The name of the component in Camelcase ie. MyNewComponent
• The section you would like MyNewComponent to sit under in the Storybookleft menu ie. Forms

It will then create a Vue component, a .stories.js file, an indes.ts (for export) and a types.ts file. These files will be populated with the basic content to allow for quick and easy scaffolding of new components. Upon running this command you should see the new component hotreloaded into Storybook.

Adding SVG Icons

When adding new SVG icons, you can use either of the following methods:

Method 1 - Manual (good for one off icons)

• Drop the SVG into the Icons/icons/svg folder ie. Icons/icons/svg/House.svg
• Create a Vue component file for the icon (use the exaxct same name) ie. Icons/icons/House.vue
• Add the SVG into the Vue component template
• Update the Icon name list export in Icons/icons/index.ts to have that icon name (this is used to output the icon in Storybook and for icon name validation).

Method 2 - Automated (WARNING - Pro level - use at your own risk!)

• Drop the SVG into the Icons/icons/svg folder
• Ensure the SVG only has the <svg>...</svg> as the top level node. Remove andy <xml ...> node
• Run npm run ico
• Look for any output errors in terminal - if there's a file name with a space, or the xml tag remains in the SVG file it won't compile properly.
• You can now add "Full Stack Developer" to your resume ;)

Changelog

[0.1.574] - 2021-09-17

Added

• Allow Date input to support dark mode