{"id":26657767,"url":"https://github.com/thedondope/crudular","last_synced_at":"2025-03-25T09:16:34.387Z","repository":{"id":38816610,"uuid":"70506305","full_name":"TheDonDope/crudular","owner":"TheDonDope","description":"An Angular CRUD example application using JWT and consuming a JSON API","archived":false,"fork":false,"pushed_at":"2025-03-19T00:09:46.000Z","size":1750,"stargazers_count":15,"open_issues_count":0,"forks_count":7,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-03-19T00:26:14.481Z","etag":null,"topics":["angular","bootstrap4","docker","font-awesome","jwt","nginx","typescript"],"latest_commit_sha":null,"homepage":"https://thedondope.github.io/crudular/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheDonDope.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"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}},"created_at":"2016-10-10T16:20:14.000Z","updated_at":"2025-03-19T00:09:44.000Z","dependencies_parsed_at":"2025-03-19T00:23:21.152Z","dependency_job_id":"d76dbd52-3c8d-417e-9f40-799a85dc4f05","html_url":"https://github.com/TheDonDope/crudular","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheDonDope%2Fcrudular","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheDonDope%2Fcrudular/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheDonDope%2Fcrudular/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheDonDope%2Fcrudular/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheDonDope","download_url":"https://codeload.github.com/TheDonDope/crudular/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245431715,"owners_count":20614184,"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":["angular","bootstrap4","docker","font-awesome","jwt","nginx","typescript"],"created_at":"2025-03-25T09:16:33.244Z","updated_at":"2025-03-25T09:16:34.367Z","avatar_url":"https://github.com/TheDonDope.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Crudular](crudular.png)\n\n# Crudular\n\n[![Angular Style Guide](https://mgechev.github.io/angular2-style-guide/images/badge.svg)](https://angular.io/styleguide) [![Conventional Commits](https://img.shields.io/badge/Conventional%20Commits-1.0.0-yellow.svg)](https://conventionalcommits.org) \n[![Build Status](https://travis-ci.org/TheDonDope/crudular.svg?branch=develop)](https://travis-ci.org/TheDonDope/crudular)\n\nThis project was generated with [Angular CLI](https://github.com/angular/angular-cli) version 1.6.3.\n\nIt uses the following npm packages (version numbers current as of [2017-03-04](https://xkcd.com/1179/)):\n\n- [Bootstrap 4.0.0-alpha.6](https://www.npmjs.com/package/bootstrap): Used for the SCSS styling of the application\n- [Font-Awesome 4.7.0](https://www.npmjs.com/package/font-awesome): Used as the glyphicon font of the application\n- [Moment 2.17.0](https://www.npmjs.com/package/moment): Used for date/time manipulation *(Note: The npm package already includes the types for moment so you do not need to add it with `npm install @types/moment --save-dev`)*\n\nIt follows the [Official Angular Styleguide](https://angular.io/styleguide).\n\n## Features\n\nThe application provides the following features:\n\n- Provide a login view to authenticate with a remote api\n- Manage a JWT authenticity token to use for calls of protected remote api methods\n- Provide a home view showing the user information about his JWT token\n- Provide a dynamic authentication-based navigation\n- Provides full Docker support for both development and production environment\n\n## Development server\n\nRun `ng serve` for a dev server. Navigate to `http://localhost:4200/`. The app will automatically reload if you change any of the source files.\n\n## Code scaffolding\n\nRun `ng generate component component-name` to generate a new component. You can also use `ng generate directive|pipe|service|class|guard|interface|enum|module`.\n\n## Build\n\nRun `ng build` to build the project. The build artifacts will be stored in the `dist/` directory. Use the `-prod` flag for a production build.\n\n## Dockerization\n\nThe application provides full Docker support. You can use it for both development as well as production builds and deployments.\n\n### How to build and start the dockerized version of the application \n\nThe Dockerization infrastructure is described in the `docker-compose.yml` (respectively `docker-compose.production.yml`.\nThe application consists of two containers:\n- `crudular-angular` - In development mode, this container serves the angular app. In production mode it builds the angular app, with the build artifacts being served by the Nginx container\n- `crudular-nginx` - This container is used only production mode. It serves the built angular app with Nginx.\n\n### Development build and deployment\n\nRun the following:\n\n```bash\n$ docker-compose build\n$ docker-compose up -d\n```\n\nNow open your browser at [http://localhost:4200](http://localhost:4200)\n\n### Production build and deployment\n\nRun the following:\n\n```bash\n$ docker-compose -f docker-compose.production.yml build\n$ docker-compose -f docker-compose.production.yml up crudular-angular   # Wait until this container has finished building, as the nginx container is dependent on the production build artifacts\n$ docker-compose -f docker-compose.production.yml up -d crudular-nginx  # Start the nginx container in detached mode\n```\n\nNow open your browser at [http://localhost:8080](http://localhost:4200)\n\n## Running unit tests\n\nRun `ng test` to execute the unit tests via [Karma](https://karma-runner.github.io).\n\n## Running end-to-end tests\n\nRun `ng e2e` to execute the end-to-end tests via [Protractor](http://www.protractortest.org/).\n\n## Commit Message Format\n\nThis project follows the [angular commit-message convention](https://github.com/conventional-changelog/conventional-changelog-angular/blob/master/convention.md).\n\n## Versioning\n\nThis project follows the [Semantic Versioning 2.0.0](http://semver.org/) specification.\n\n## Bumping Version Number\n\nIf you follow semantic versioning and use the [angular commit-message convention](https://github.com/conventional-changelog/conventional-changelog-angular/blob/master/convention.md), you can use the following npm task to get the appropiate next version number\n\n```bash\n$ npm run bump-version\n```\n\n## Releasing\n\nYou can use the following workflow to ease your release process:\n\n*Note: The following scripts use the npm-packages [conventional-github-releaser](https://github.com/conventional-changelog/conventional-github-releaser), [conventional-recommended-bump](https://github.com/conventional-changelog/conventional-recommended-bump) and [standard-changelog](https://github.com/conventional-changelog/standard-changelog). Make sure you install them first by running: `npm install -g conventional-github-releaser conventional-recommended-bump standard-changelog`. Furthermore, [gitflow](https://github.com/nvie/gitflow) is partially used for the following commands*\n\n0. Given your project was initialized with `$ git flow init` and your current branch being `develop` is ready to be released, do the following\n1. Get your next-version number:`$ npm run bump-version`\n2. Start your next-release: `$ git flow release start \u003cnext-version-from-step-1\u003e`\n3. Bump the version number in your `package.json` with the version from step 1\n4. Generate your `CHANGELOG.md`: `$ npm run changelog`\n5. Make your release commit: `$ git add --all \u0026\u0026 git commit -m 'chore(release): \u003cnext-version-from-step-1\u003e'`\n6. Finish your release: `$ git flow release finish \u003cnext-version-from-step-1\u003e`\n7. Push your branches and tags to GitHub: `$ git push origin master \u0026\u0026 git push origin develop \u0026\u0026 git push origin --tags`\n8. Draft and publish your GitHub Relase: `$ npm run github-release`\n\n## Further help\n\nTo get more help on the Angular CLI use `ng help` or go check out the [Angular CLI README](https://github.com/angular/angular-cli/blob/master/README.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthedondope%2Fcrudular","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthedondope%2Fcrudular","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthedondope%2Fcrudular/lists"}