{"id":48819485,"url":"https://github.com/vaadin/base-starter-flow-osgi","last_synced_at":"2026-04-14T14:02:44.023Z","repository":{"id":33972366,"uuid":"158569063","full_name":"vaadin/base-starter-flow-osgi","owner":"vaadin","description":"Project base for Vaadin Flow and OSGi","archived":false,"fork":false,"pushed_at":"2026-01-12T08:44:06.000Z","size":4368,"stargazers_count":7,"open_issues_count":2,"forks_count":7,"subscribers_count":6,"default_branch":"v23","last_synced_at":"2026-01-14T01:09:15.329Z","etag":null,"topics":["felix","java","osgi","project-template","vaadin","vaadin-flow","web-application","webapp"],"latest_commit_sha":null,"homepage":"https://vaadin.com/flow","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vaadin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2018-11-21T15:29:25.000Z","updated_at":"2026-01-12T08:44:09.000Z","dependencies_parsed_at":"2023-02-13T21:01:14.365Z","dependency_job_id":"62eaa791-6235-4d07-8f9d-818b402e5ccb","html_url":"https://github.com/vaadin/base-starter-flow-osgi","commit_stats":null,"previous_names":[],"tags_count":0,"template":true,"template_full_name":null,"purl":"pkg:github/vaadin/base-starter-flow-osgi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaadin%2Fbase-starter-flow-osgi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaadin%2Fbase-starter-flow-osgi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaadin%2Fbase-starter-flow-osgi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaadin%2Fbase-starter-flow-osgi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vaadin","download_url":"https://codeload.github.com/vaadin/base-starter-flow-osgi/tar.gz/refs/heads/v23","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vaadin%2Fbase-starter-flow-osgi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31799411,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-14T11:13:53.975Z","status":"ssl_error","status_checked_at":"2026-04-14T11:13:53.299Z","response_time":153,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["felix","java","osgi","project-template","vaadin","vaadin-flow","web-application","webapp"],"created_at":"2026-04-14T14:02:43.224Z","updated_at":"2026-04-14T14:02:43.997Z","avatar_url":"https://github.com/vaadin.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Base Starter Parent project for Vaadin Flow and OSGi in NPM mode\n\nThis project can be used as a starting point to create your own Vaadin Flow application bundle for OSGi.\nIt has the necessary dependencies and files to help you get started.\n**This project has been revised for Vaadin 19 (GA in March 2021) which brings back OSGi support in npm mode.\nFor now, it Vaadin OSGi support is only for Flow based views (Java UIs), but not for Fusion (TypeScript UIs).**\n\nFor more Vaadin usage samples, you can go to vaadin.com/start.\n\nTo access it directly from github, clone the repository and import the project to the IDE of your choice as a Maven project. You need to have Java 8 or 11 installed.\n\nThe project consist of two subprojects: \n- starter\n- app\n\nThe `starter` project contains the code for Web Application Bundle (WAB) which can be deployed\nto any OSGi container.\n\nThe `app` project contains infrastructure which allows to build an executable JAR file.\nThe resulting application starts OSGi container with all necessary dependencies. It's a fast\nway to check the WAB inside OSGi environment.\n\n\n## Build and run a Vaadin web application OSGi bundle \n\nThe simplest way to start the project is run command `mvn install` and then\nrun `java -jar app/target/app.jar`.\n\nThe starter project may be built via `mvn -pl starter install` command.\nThen `mvn -pl app bnd-resolver:resolve` command may be used to generate list of bundles required \nat runtime in OSGi container and the app can be started via `mvn -pl app bnd-run:run` command.\n\n\n## Deploying Vaadin specific bundles to an OSGi container\n\nVaadin application generally contains dependencies to other bundles: e.g. Vaadin components like `Button`,\n`TextField` , etc. Every Vaadin component is based on a Web Component which\nis represented by frontend resources. All frontend resources are built into a bundle\nalong with Vaadin WAB. As a result:\n - any Vaadin component bundle update is possible only within the same minor version, \n so that the Web Component version stays the same (and only Java code is updated). We don't recommend \n updating any version over a minor for Flow or the web component Flow integrations (even though it's\n not prevented anyhow at the moment).\n - Updating any bundle that has frontend resources requires that the frontend build goal `build-frontend` \n is run and the WAB is redeployed to get the static frontend bundle updated.\n\n\n## Limitations\n\nSee Limitations section in the starter project [README.md](starter/README.md).\n\n:warning:\nAt the moment, it is not possible to modify frontend resources on the fly (webpack dev server is not available at runtime). This means that for every frontend change, you have to rebuild the frontend bundle. ([Issue for devmode](https://github.com/vaadin/flow/issues/9108))\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaadin%2Fbase-starter-flow-osgi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvaadin%2Fbase-starter-flow-osgi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvaadin%2Fbase-starter-flow-osgi/lists"}