A showcase app for all Ionic UI elements - up to Ionic 5!!! Use this app to try-out the elements you like for your app, and then navigate directly to the API docs or the source code.
Secondly, it is a boilerplate to start developing an Ionic/Svelte/PWA supercharged app (WIP)
Published as web app: https://ionicsvelte.firebaseapp.com
Hint: try reactivity of the app by using various devices or the Chrome developer view: iOS, Android's material design and fullscreen desktop responsiveness guaranteed!
If you want to run it locally:
npm install -g degit
degit Tommertom/svelte-ionic-app svelte-ionic-app
cd svelte-ionic-app
npm i
npm run dev
Why npm run build sometimes while developing? -> there is a copy script copying many assets to build folder. Having this script run in dev-mode slows down development flow. So strictly spoken, you only need to run this once for this project. So, if you run npm run dev, your assets will be copied. If you want this standard behavior, change rollup.config.js.
The app will be served on localhost:5000
.
Please note: livereload not enabled (see rollup.config.js
) because of issue in development environment.
All items also available as individual REPLs: https://github.com/Tommertom/svelte-ionic-app/blob/master/REPLS.md
If you have user requests, please raise an issue @ github, or drop a note using the "RateMe" feature in the menu. Some of these comments received and resolved:
- Margin in the SourceViewer
- Stop the begging for Rating
Please check the issue list for other issues resolved.
I am very happy to get feedback and to make it more usefull to all!
NEW FEATURE: click to view source! For all components (except tab) you can click the lower right source button to view the source and copy/paste in your app. If you use fullscreen view, the menu will be a sidepanel instead of a hamburger!
NEW FEATURE: click on share button in source view to link directly to the Ionic API docs
NEW FEATURE: almost all UI elements have a separate REPL (coding playground)
NEW FEATURE: Web Animations API included (see Avatars)
NEW FEATURE: TYPESCRIPT ARRIVED!!!!! Configuration done and usable via <script lang="ts">
(I just need to add some types to the IonicController.ts so you don't get red curls)
NEW FEATURE: JAVASCRIPT CODE ADDED!!!
NEW FEATURE: RATE ME FEATURE ADDED
Yes, I like to get your feedback! And I do wonder why I cant get the navigated URL as a store, so I had to make a separate one...
All features (vision/realised)
- Rate me - popup to see hear what your user thinks (100%)
- Configured for Typescript usage (100%)
- Web Animations API (see Avatars - 100% done)
- All Ionic Framework UI components showcased (100% done)
- Run as SPA - Filesystem router via Routify (100% done)
- Code splitting - lazy loading of routes (100%)
- Service Worker setup via workbox (75% - not really doing much this way)
- PWA compliance via Ligthouse score (80% - biggest issue: no 200 when offline)
- RXJS usage (100%)
- Localstorage via localforage (100%)
- Firebase SDK - analytics/firestore (100%)
- Capacitor for mobile native support (100%)
- Ionic Theming in local styles and global CSS (100%)
- REPLs for each element (100%)
- Source code previewer (100%)
- Cookie Popup (100%)
- Ionic included as asset, not CDN (100%)
- Setting global CSS variables - (https://ionicframework.com/docs/theming/css-variables (100%) - see App.svelte)
And the source view with copy feature and you can select text with the mouse:
Do you like this work? Please star this project!
These are not always available for all packages used in this project, and hence not applied.
I think I need to debug a bit more, because ionInput does fire..... And the show-cancel-button "never" also does not work.
The REPLs are Ionic 4. I think they still sufficiently serve purpose to play around with the UI, so for now I won't bother too much updating them.
Ion Back Button does not appear in the app. Neither in a REPL. Made a custom version.
Needing some debugging - A NAV in the TAB is not working properly
Copy of sourcecode on iOS does not seem to work.
Pane needs ion-content to be set to scroll-y:false
to avoid strange UI on some devices.
This is something that requires a bit more work on my end - finding the right toolbox to do 200 when offline and at the same time a developer friendly implementation for changes. Probably it exists already, but just need to research a bit more.
In Cards there is a link that navigates away from the current page. It does not nicely replace the page, as it fully reloads. That is not very nice if you ask me, so you have to use a navigate
method instead of href. That is a bit unfortunate if you ask me (from SEO perspective - correct?)
If you want to set properties for Ionic elements, you need to use the attribute
as defined in the docs. Example:
- not ok:
<ion-content scrollX="true">...</ion-content>
- ok:
<ion-content scroll-x="true">...</ion-content>
Not necessarily an issue, but still a bit undesireable to make a custom element to be using a IonNav (as in <ion-nav root="my-element">
). Therefore made IonNav.svelte to handle this and developers can include svelte component instead of manually registering a customElement.
I raised an issue @ Ionic for selected-tab not selecting te default tab as per Ionic's documentation. ionic-team/ionic-framework#20060
This seems to be related to the ionic router that is not working for me. IonPage.svelte could be a replacement for a flyin type of animation.
Local install (in index.html):
<script type="module" src='/assets/libs/@ionic/core/dist/ionic/ionic.js'></script>
<link rel="stylesheet" href="/assets/libs/@ionic/core/css/ionic.bundle.css" />
Obviously you need to put the NPM lib of @ionic in the assets folder.
A number of todo's:
- Add some other Ionic things like Platform
- Ionic 6 - launched in Dec 2021!
- Github comment by AlexRMU on opening modals Tommertom#15 (comment)
Snowpack instead of rollupCopy snippets of source codeImplement workbox and spassr as shown in the startertemplate of routify (or at least check) - using https://github.com/OliwerDrywa/svelte-pwa/blob/master/public/service-worker.jsfix IonTabfix Ionic Menu close, go through all components and fix some messagesresearch some of the warnings after Ionic 5 migrationIonic 5 add-ons not present in Ionic 4 (to figure out which ones)UI elements missing: VirtualScroll skippedadd the popoover and other controller related itemstry the css styling as per documentation (theming)look at awesome rollup and add typescript -not mature enough!!fix rollup copy of files in assets folderdo some binding on inputs and other interactive elementsionicons for menu - colors and other namesionicons part has some unknown icons, make larger- make it a better PWA - need to work on the service worker - https://developers.google.com/web/tools/workbox/guides/get-started
better names for controller API?NAV over tabmake it more sveltish (code, store, bindings, animations)publish on firebase hostingtry some cordova/ionic native - no web features I needsingleton classes https://alligator.io/js/js-singletons/place routes in better place (pages folder probably, to avoid repeating /../)consider Contexts for exposing controllerssplit panesearchbox in ionicons- add non Ionic elements to complete UI:
chat ui and other social elements (https://github.com/thenaim/ionic-tk-social-network) - nope, won't do thisStimelineSaccordion - part of Ionic 6pane - part of Ionic 6
SSRto docs link https://ionicframework.com/docs/api/input- https://css-tricks.com/what-i-like-about-writing-styles-with-svelte/
- https://github.com/pngwn/prism-svelte or something else that works
REPLschange router? https://github.com/qutran/swheel, https://github.com/jorgegorka/svelte-router/blob/master/README.md- ~~ source code formatter in HTML - won't do this~~
Font Awesome icons - won't do thisWeb Animations API trial - see Avatarsreplace manual route filter with ignore optionSseek ways to include in rollup bundler instead of script includeSSIonic 5 migration - once it is fully released - already some breaking changesS