{"id":19693887,"url":"https://github.com/jhipster/jhipster-lite","last_synced_at":"2025-05-15T04:02:33.953Z","repository":{"id":36951876,"uuid":"388727019","full_name":"jhipster/jhipster-lite","owner":"jhipster","description":"JHipster Lite ⚡ is a development platform to generate, develop \u0026 deploy modern web applications \u0026 microservices architecture, step by step - using Hexagonal Architecture :gem:","archived":false,"fork":false,"pushed_at":"2025-05-12T05:14:21.000Z","size":63145,"stargazers_count":501,"open_issues_count":76,"forks_count":224,"subscribers_count":25,"default_branch":"main","last_synced_at":"2025-05-12T19:28:49.228Z","etag":null,"topics":["generator","hacktoberfest","hexagonal-architecture","java","jhipster","spring-boot","typescript","vuejs"],"latest_commit_sha":null,"homepage":"https://lite.jhipster.tech","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jhipster.png","metadata":{"funding":{"open_collective":"generator-jhipster","custom":"https://www.jhipster.tech/sponsors/"},"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","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}},"created_at":"2021-07-23T08:11:19.000Z","updated_at":"2025-05-12T04:42:35.000Z","dependencies_parsed_at":"2024-11-05T16:04:12.719Z","dependency_job_id":"6326befa-f4cb-4da9-97cf-b60a00005ddc","html_url":"https://github.com/jhipster/jhipster-lite","commit_stats":{"total_commits":12145,"total_committers":100,"mean_commits":121.45,"dds":"0.47879785920131746","last_synced_commit":"03a053a7e41908e1f2b96a29c93c112708e49716"},"previous_names":[],"tags_count":106,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhipster%2Fjhipster-lite","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhipster%2Fjhipster-lite/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhipster%2Fjhipster-lite/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jhipster%2Fjhipster-lite/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jhipster","download_url":"https://codeload.github.com/jhipster/jhipster-lite/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254270640,"owners_count":22042858,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["generator","hacktoberfest","hexagonal-architecture","java","jhipster","spring-boot","typescript","vuejs"],"created_at":"2024-11-11T19:18:42.712Z","updated_at":"2025-05-15T04:02:33.932Z","avatar_url":"https://github.com/jhipster.png","language":"Java","funding_links":["https://opencollective.com/generator-jhipster","https://www.jhipster.tech/sponsors/"],"categories":[],"sub_categories":[],"readme":"[![Logo JHipster Lite][jhipster-image]][jhipster-url]\n\n# JHipster Lite ⚡\n\n[![JHipster Lite version][jhipster-lite-release-version]][jhipster-lite-release-url]\n[![JHipster Lite Maven Central][jhipster-lite-maven-central-version]][jhipster-lite-maven-central-url]\n[![JHipster Lite Docker Hub][jhipster-lite-docker-hub]][jhipster-lite-docker-hub-url]\n\n[![Build Status][github-actions-jhlite-image]][github-actions-url]\n[![sonarcloud-coverage][sonarcloud-coverage]][sonarcloud-url]\n\n[![sonarcloud-quality-gate][sonarcloud-quality-gate]][sonarcloud-url]\n[![sonarcloud-maintainability][sonarcloud-maintainability]][sonarcloud-url]\n\n[![sonarcloud-bugs][sonarcloud-bugs]][sonarcloud-url]\n[![sonarcloud-vulnerabilities][sonarcloud-vulnerabilities]][sonarcloud-url]\n[![sonarcloud-security][sonarcloud-security]][sonarcloud-url]\n[![sonarcloud-code-smells][sonarcloud-code-smells]][sonarcloud-url]\n\n[![Revved up by Develocity][develocity-badge]][develocity-url]\n\n## Description\n\n[JHipster][jhipster-url] is a development platform to quickly generate, develop \u0026 deploy modern web applications \u0026 microservice architectures.\n\n**JHipster Lite** will help you to start your project by generating step by step only what you need.\n\n- The generated code uses [Hexagonal Architecture](./documentation/hexagonal-architecture.md)\n- The technical code is separated from your business code\n- You will only generate the code you want, no additional unused code\n- The best quality as possible: 💯% coverage, 0 code smell, no duplication 😎\n\nThis is a [sample application](https://github.com/jhipster/jhipster-lite-sample-app) created with JHipster Lite.\n\n## Quick Start\n\nYou need to clone this project and go into the folder:\n\n```\ngit clone https://github.com/jhipster/jhipster-lite\ncd jhipster-lite\n```\n\nRun the project:\n\n```bash\n./mvnw\n```\n\nThen, you can navigate to http://localhost:7471 in your browser.\n\n## Some videos\n\n- [What is JHipster Lite and why should you care?][devoxx-jhlite] by [Julien Dubois][jdubois]\n- [Simple WebServices with JHipster Lite][webservices-with-jhlite] by [Colin Damon][cdamon]\n- [JHipster vs JHipster Lite][jhipster-vs-jhlite] by [Julien Dubois][jdubois]\n\n## Choosing\n\nThe original JHipster and JHLite are **not the same thing**, they are **not generating the same code** and **not serving the same purpose**! Here are some choice elements you can take into account:\n\n![Choosing JHipster](documentation/jhlite-choice.png)\n\n## Prerequisites\n\n### Java\n\nYou need to have Java 21:\n\n- [JDK 21](https://openjdk.java.net/projects/jdk/21/)\n\n### Node.js and NPM\n\n- [Node.js](https://nodejs.org/): we use Node to run a development web server and build the project. Depending on your system, you can install Node either from source or as a pre-packaged bundle.\n\nAfter installing Node, you should be able to run the following command to install development tools.\n\n```bash\nnpm ci\n```\n\nYou will only need to run this command when dependencies change in [package.json](package.json).\n\n```bash\nnpm install\n```\n\n## Test the project\n\nTo launch tests:\n\n```bash\n./mvnw clean test\n```\n\nTo launch tests and integration tests:\n\n```bash\n./mvnw clean verify\n```\n\n## GraalVM Native Support\n\nThis project has been configured to let you generate either a lightweight container or a native executable. It is also possible to run your tests in a native image.\nLightweight Container with Cloud Native Buildpacks\n\nIf you're already familiar with Spring Boot container images support, this is the easiest way to get started.\nDocker should be installed and configured on your machine prior to creating the image.\n\nTo create the image, run the following goal:\n\n```bash\n./mvnw spring-boot:build-image -Pnative\n```\n\nThen, you can run the app like any other container:\n\n```bash\ndocker run -p 7471:7471 --rm docker.io/library/jhlite:\u003cVERSION\u003e\n```\n\n## Executable with Native Build Tools\n\nUse this option if you want to explore more options such as running your tests in a native image.\nThe GraalVM native-image compiler should be installed and configured on your machine.\n\nNOTE: GraalVM 22.3+ is required.\n\nTo create the executable, run the following goal:\n\n```bash\n./mvnw native:compile -Pnative -DskipTests\n```\n\nThen, you can run the app as follows:\n\n```bash\n./target/jhlite\n```\n\nYou can also run your existing tests suite in a native image. This is an efficient way to validate the compatibility of your application.\n\nTo run your existing tests in a native image, run the following goal:\n\n```bash\n./mvnw test -PnativeTest\n```\n\n## Lint\n\nWe use multiple linters check and lint your code:\n\n- [ESLint](https://eslint.org/) for JavaScript/TypeScript\n- [Prettier](https://github.com/prettier/prettier) for the format\n  - [prettier-java](https://github.com/jhipster/prettier-java) for Java\n- [Stylelint](https://stylelint.io/) for style\n  - [stylelint-scss](https://github.com/stylelint-scss) for SCSS\n\nTo check:\n\n```bash\nnpm run lint:ci\n```\n\nTo lint and fix all code:\n\n```bash\nnpm run lint\n```\n\n## Sonar Analysis\n\nTo launch local Sonar Analysis:\n\n```bash\ndocker compose -f src/main/docker/sonar.yml up -d\n```\n\nThen:\n\n```bash\n./mvnw clean verify sonar:sonar\n```\n\nSo you can check the result at http://localhost:9001\n\n## Run the project\n\nYou can run the project using Maven, as `spring-boot:run` is the default target:\n\n```bash\n./mvnw\n```\n\nOr, first, you can package as jar:\n\n```bash\n./mvnw package\n```\n\nThen, run:\n\n```bash\njava -jar target/*.jar\n```\n\nSo you can navigate to http://localhost:7471 in your browser.\n\nThese following profiles are available, and you can use it to only display the frameworks you want:\n\n- angular\n- react\n- vue\n\nFor example, you can run:\n\n```bash\n./mvnw -Dspring-boot.run.profiles=vue\n```\n\nor\n\n```bash\njava -jar target/*.jar --spring.profiles.active=vue\n```\n\n## Docker/Podman Quickstart\n\nTo start a local instance of JHipster Lite, go to your desired application folder and run:\n\n```bash\ndocker run --rm --pull=always -p 7471:7471 -v $(pwd):/tmp/jhlite:Z -it jhipster/jhipster-lite:latest\n```\n\nOr with podman:\n\n```bash\npodman run --rm --pull=always -p 7471:7471 -v $(pwd):/tmp/jhlite:Z -u root -it jhipster/jhipster-lite:latest\n```\n\nThen, go to [http://localhost:7471](http://localhost:7471)\n\n## e2e tests\n\nYou need to run the project first. Then, you can run the end-to-end tests:\n\n```bash\nnpm run e2e\n```\n\nOr in headless mode:\n\n```bash\nnpm run e2e:headless\n```\n\n## Generate your project\n\nOnce started, go to http://localhost:7471, select your option and generate the code you want, step by step, and only what you need.\n\n## Contributing\n\nWe are honored by any contributions you may have small or large. Please refer to our [contribution guidelines and instructions document](https://github.com/jhipster/jhipster-lite/blob/main/CONTRIBUTING.md) for any information about contributing to the project.\n\n## Sponsors\n\nSupport this project by becoming a sponsor! [Become a sponsor](https://opencollective.com/generator-jhipster) or [learn more about sponsoring the project](https://www.jhipster.tech/sponsors/).\n\n**Thank you to our sponsors!**\n\n### Bronze sponsors\n\n[![BronzeSponsors][bronze-sponsors-image]][bronze-sponsors-url]\n\n### Backers\n\n**Thank you to all our backers!**\n\n[![Backers][backers-image]][backers-url]\n\n[jhipster-lite-release-version]: https://img.shields.io/github/v/release/jhipster/jhipster-lite\n[jhipster-lite-release-url]: https://github.com/jhipster/jhipster-lite/releases\n[jhipster-lite-maven-central-version]: https://img.shields.io/maven-central/v/tech.jhipster.lite/jhlite?color=blue\n[jhipster-lite-maven-central-url]: https://repo.maven.apache.org/maven2/tech/jhipster/lite/jhlite/\n[jhipster-lite-docker-hub]: https://img.shields.io/badge/Docker%20Hub-jhipster%2Fjhipster--lite-blue.svg?style=flat\n[jhipster-lite-docker-hub-version]: https://img.shields.io/docker/v/jhipster/jhipster-lite?color=0073ec\n[jhipster-lite-docker-hub-url]: https://hub.docker.com/r/jhipster/jhipster-lite\n[github-actions-jhlite-image]: https://github.com/jhipster/jhipster-lite/actions/workflows/github-actions.yml/badge.svg?branch=main\n[github-actions-url]: https://github.com/jhipster/jhipster-lite/actions\n[jhipster-image]: https://raw.githubusercontent.com/jhipster/jhipster-artwork/main/logos/lite/JHipster-Lite-neon-blue.png\n[jhipster-url]: https://www.jhipster.tech/\n[sonarcloud-url]: https://sonarcloud.io/project/overview?id=jhipster_jhipster-lite\n[sonarcloud-quality-gate]: https://sonarcloud.io/api/project_badges/measure?project=jhipster_jhipster-lite\u0026metric=alert_status\n[sonarcloud-maintainability]: https://sonarcloud.io/api/project_badges/measure?project=jhipster_jhipster-lite\u0026metric=sqale_rating\n[sonarcloud-bugs]: https://sonarcloud.io/api/project_badges/measure?project=jhipster_jhipster-lite\u0026metric=bugs\n[sonarcloud-vulnerabilities]: https://sonarcloud.io/api/project_badges/measure?project=jhipster_jhipster-lite\u0026metric=vulnerabilities\n[sonarcloud-security]: https://sonarcloud.io/api/project_badges/measure?project=jhipster_jhipster-lite\u0026metric=security_rating\n[sonarcloud-code-smells]: https://sonarcloud.io/api/project_badges/measure?project=jhipster_jhipster-lite\u0026metric=code_smells\n[sonarcloud-coverage]: https://sonarcloud.io/api/project_badges/measure?project=jhipster_jhipster-lite\u0026metric=coverage\n[backers-image]: https://opencollective.com/generator-jhipster/tiers/backer.svg?avatarHeight=70\u0026width=890\n[backers-url]: https://opencollective.com/generator-jhipster\n[bronze-sponsors-image]: https://opencollective.com/generator-jhipster/tiers/bronze-sponsor.svg?avatarHeight=120\u0026width=890\n[bronze-sponsors-url]: https://opencollective.com/generator-jhipster\n[devoxx-jhlite]: https://youtu.be/RnLGnY-vzLI\n[jdubois]: https://twitter.com/juliendubois\n[webservices-with-jhlite]: https://youtu.be/mEECPRZjajI\n[jhipster-vs-jhlite]: https://youtu.be/t5GA329FMfU\n[cdamon]: https://www.linkedin.com/in/colin-damon/\n[develocity-badge]: https://img.shields.io/badge/Revved%20up%20by-Develocity-06A0CE?logo=Gradle\u0026labelColor=02303A\n[develocity-url]: https://ge.jhipster.tech/scans\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjhipster%2Fjhipster-lite","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjhipster%2Fjhipster-lite","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjhipster%2Fjhipster-lite/lists"}