{"id":15051401,"url":"https://github.com/nextcloud/firstrunwizard","last_synced_at":"2025-04-05T17:07:51.486Z","repository":{"id":9135026,"uuid":"60987039","full_name":"nextcloud/firstrunwizard","owner":"nextcloud","description":"🔮 The first impression matters. The firstrunwizard is the first Nextcloud impression.","archived":false,"fork":false,"pushed_at":"2025-03-29T03:04:21.000Z","size":108390,"stargazers_count":45,"open_issues_count":16,"forks_count":51,"subscribers_count":9,"default_branch":"master","last_synced_at":"2025-03-29T03:22:43.876Z","etag":null,"topics":["nextcloud","welcome","wizard"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","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/nextcloud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/contributing.md","funding":null,"license":"LICENSES/AGPL-3.0-or-later.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":"AUTHORS.md","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-06-12T20:11:36.000Z","updated_at":"2025-03-27T00:58:45.000Z","dependencies_parsed_at":"2024-01-22T22:04:58.414Z","dependency_job_id":"6d6eab8f-38ec-4294-acd5-5a5884f8ffa4","html_url":"https://github.com/nextcloud/firstrunwizard","commit_stats":{"total_commits":2346,"total_committers":67,"mean_commits":"35.014925373134325","dds":0.613384484228474,"last_synced_commit":"63dc980540b05ad6cac8683bc2c46ca8777396d2"},"previous_names":[],"tags_count":775,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Ffirstrunwizard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Ffirstrunwizard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Ffirstrunwizard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nextcloud%2Ffirstrunwizard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nextcloud","download_url":"https://codeload.github.com/nextcloud/firstrunwizard/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247369952,"owners_count":20927928,"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":["nextcloud","welcome","wizard"],"created_at":"2024-09-24T21:34:29.510Z","updated_at":"2025-04-05T17:07:51.458Z","avatar_url":"https://github.com/nextcloud.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n  - SPDX-FileCopyrightText: 2016-2024 Nextcloud GmbH and Nextcloud contributors\n  - SPDX-FileCopyrightText: 2013-2016 ownCloud, Inc.\n  - SPDX-License-Identifier: AGPL-3.0-or-later\n--\u003e\n# 🔮 First run wizard\n\n[![REUSE status](https://api.reuse.software/badge/github.com/nextcloud/firstrunwizard)](https://api.reuse.software/info/github.com/nextcloud/firstrunwizard)\n\nA first run wizard that explains the usage of Nextcloud to new users\n\n![](https://user-images.githubusercontent.com/3404133/51537050-bcc73e00-1e4d-11e9-8de0-29e6951c2b29.png)\n\n## Configuration\n\nNo configuration is needed, but it is possible to prevent the wizard from opening for users by default.\nWhen disabled users can only open it from manually clicking \"About\" in the user menu.\n\nThis can be done by setting an app setting value:\n\n```\nocc config:app:set --value false firstrunwizard wizard_enabled\n```\n\n## Development setup\n\nMake sure you have `node`, `npm` and `make` installed on your system.\n\n1. ☁ Clone the app into the `apps` folder of your Nextcloud: `git clone https://github.com/nextcloud/firstrunwizard.git`\n2. 👩‍💻 Run `npm ci` to install the dependencies\n3. 🏗 To build the Javascript after you have made changes, run `npm run build`\n4. ✅ Enable the app through the app management of your Nextcloud\n5. 🎉 Partytime! Help fix [some issues](https://github.com/nextcloud/firstrunwizard/issues) and [review pull requests](https://github.com/nextcloud/firstrunwizard/pulls) 👍\n\n### Add Nextcloud Hub release notes\n\n1. Open the `src/hub-release.ts` file\n2. Adjust the `version` property to reflect the new Hub release version\n3. Adjust the `link` (e.g. blog post)\n4. Add `releaseNotes`, this is an array of strings, for localization those are translated using `t('firstrunwizard', 'YOUR MESSAGE')`\n5. Change the `videoAltText` for the Hub release animation if needed (alternative text for accessibility)\n6. Adjust the `shareSubject` which is used when users share their thoughts about the release on social media\n7. Replace `img/nextcloudHub.mp4` and `img/nextcloudHub.webm` (VP9) with updated animations\n8. Update the current changelog version in `lib/Constants.php`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextcloud%2Ffirstrunwizard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnextcloud%2Ffirstrunwizard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextcloud%2Ffirstrunwizard/lists"}