From 1150fbaf087c732d42fff6e3bc5e0aa794f00911 Mon Sep 17 00:00:00 2001 From: Daniel Loreto <279789+loreto@users.noreply.github.com> Date: Fri, 10 Oct 2025 14:45:01 -0500 Subject: [PATCH] Remove docs and documentation app Deleted all files related to documentation, including configuration, markdown, images, and source files under the docs/ and docs/app/ directories. This removes the Docusaurus-based documentation site and its supporting assets from the repository. --- docs/.dockerignore | 3 - docs/.gitignore | 29 - docs/.markdownlint.yaml | 10 - docs/Dockerfile | 6 - docs/README.md | 43 - docs/app/.envrc | 9 - docs/app/.gitignore | 21 - docs/app/.yarnrc.yml | 1 - docs/app/babel.config.js | 3 - docs/app/cloud/_category_.json | 4 - docs/app/cloud/cache/authenticating.md | 63 - docs/app/cloud/cache/index.md | 23 - docs/app/cloud/cache/prebuilt_cache.md | 36 - docs/app/cloud/cache/usage.md | 51 - docs/app/cloud/dashboard/_category_.json | 4 - .../app/cloud/dashboard/creating_your_team.md | 30 - docs/app/cloud/dashboard/index.md | 16 - docs/app/cloud/dashboard/inviting_members.md | 47 - docs/app/cloud/deploys/_category_.json | 5 - docs/app/cloud/deploys/custom_domains.md | 27 - docs/app/cloud/deploys/index.md | 51 - .../deploys/integrations/_category_.json | 4 - docs/app/cloud/deploys/integrations/index.md | 9 - docs/app/cloud/deploys/integrations/s3.md | 32 - .../cloud/deploys/integrations/supabase.md | 66 - .../app/cloud/deploys/integrations/upstash.md | 43 - docs/app/cloud/deploys/monitoring_deploys.md | 30 - docs/app/cloud/deploys/secrets.md | 13 - docs/app/cloud/deploys/setup.md | 77 - docs/app/cloud/faq.md | 56 - docs/app/cloud/index.md | 32 - docs/app/cloud/secrets/_category_.json | 4 - docs/app/cloud/secrets/dashboard_secrets.md | 33 - docs/app/cloud/secrets/index.md | 24 - docs/app/cloud/secrets/secrets_cli.md | 138 - docs/app/cloud/sidebar.ts | 59 - docs/app/cloud_sidebars.js | 23 - docs/app/devbox.json | 18 - docs/app/devbox.lock | 73 - docs/app/docs/cli_reference/_category_.json | 4 - docs/app/docs/cli_reference/devbox.md | 30 - docs/app/docs/cli_reference/devbox_add.md | 56 - docs/app/docs/cli_reference/devbox_cache.md | 17 - .../cli_reference/devbox_cache_configure.md | 28 - .../docs/cli_reference/devbox_cache_info.md | 14 - .../docs/cli_reference/devbox_cache_upload.md | 23 - .../docs/cli_reference/devbox_completion.md | 25 - .../cli_reference/devbox_completion_bash.md | 47 - .../cli_reference/devbox_completion_fish.md | 36 - .../cli_reference/devbox_completion_zsh.md | 59 - docs/app/docs/cli_reference/devbox_create.md | 39 - .../app/docs/cli_reference/devbox_generate.md | 28 - .../devbox_generate_devcontainer.md | 26 - .../cli_reference/devbox_generate_direnv.md | 22 - .../devbox_generate_dockerfile.md | 27 - .../cli_reference/devbox_generate_readme.md | 21 - docs/app/docs/cli_reference/devbox_global.md | 35 - .../docs/cli_reference/devbox_global_add.md | 49 - .../cli_reference/devbox_global_install.md | 19 - .../docs/cli_reference/devbox_global_list.md | 22 - .../docs/cli_reference/devbox_global_pull.md | 19 - .../docs/cli_reference/devbox_global_push.md | 19 - .../docs/cli_reference/devbox_global_rm.md | 19 - .../docs/cli_reference/devbox_global_run.md | 39 - .../cli_reference/devbox_global_services.md | 21 - .../cli_reference/devbox_global_shellenv.md | 28 - .../cli_reference/devbox_global_update.md | 27 - docs/app/docs/cli_reference/devbox_info.md | 26 - docs/app/docs/cli_reference/devbox_init.md | 24 - docs/app/docs/cli_reference/devbox_install.md | 23 - docs/app/docs/cli_reference/devbox_rm.md | 20 - docs/app/docs/cli_reference/devbox_run.md | 51 - docs/app/docs/cli_reference/devbox_search.md | 45 - docs/app/docs/cli_reference/devbox_secrets.md | 30 - .../cli_reference/devbox_secrets_download.md | 26 - .../docs/cli_reference/devbox_secrets_init.md | 17 - .../docs/cli_reference/devbox_secrets_list.md | 26 - .../docs/cli_reference/devbox_secrets_rm.md | 24 - .../docs/cli_reference/devbox_secrets_set.md | 24 - .../cli_reference/devbox_secrets_upload.md | 25 - .../app/docs/cli_reference/devbox_services.md | 27 - .../cli_reference/devbox_services_attach.md | 21 - .../docs/cli_reference/devbox_services_ls.md | 20 - .../cli_reference/devbox_services_restart.md | 26 - .../cli_reference/devbox_services_start.md | 25 - .../cli_reference/devbox_services_stop.md | 22 - .../docs/cli_reference/devbox_services_up.md | 41 - docs/app/docs/cli_reference/devbox_shell.md | 32 - .../app/docs/cli_reference/devbox_shellenv.md | 24 - docs/app/docs/cli_reference/devbox_update.md | 30 - docs/app/docs/cli_reference/devbox_version.md | 26 - .../cli_reference/devbox_version_update.md | 20 - docs/app/docs/configuration.md | 322 - .../continuous_integration/github_action.md | 49 - docs/app/docs/contributor-quickstart.md | 90 - .../docs/devbox_examples/databases/mariadb.md | 85 - .../docs/devbox_examples/databases/mongodb.md | 62 - .../docs/devbox_examples/databases/mysql.md | 92 - .../devbox_examples/databases/postgres.md | 89 - .../devbox_examples/databases/rabbitmq.md | 76 - .../docs/devbox_examples/databases/redis.md | 66 - .../docs/devbox_examples/databases/valkey.md | 66 - docs/app/docs/devbox_examples/index.md | 46 - .../docs/devbox_examples/languages/csharp.md | 26 - .../docs/devbox_examples/languages/elixir.md | 59 - .../docs/devbox_examples/languages/fsharp.md | 24 - docs/app/docs/devbox_examples/languages/go.md | 57 - .../docs/devbox_examples/languages/haskell.md | 22 - .../docs/devbox_examples/languages/java.md | 107 - .../app/docs/devbox_examples/languages/nim.md | 21 - .../docs/devbox_examples/languages/nodejs.md | 63 - .../app/docs/devbox_examples/languages/php.md | 82 - .../docs/devbox_examples/languages/python.md | 138 - .../docs/devbox_examples/languages/ruby.md | 64 - .../docs/devbox_examples/languages/rust.md | 35 - .../app/docs/devbox_examples/languages/zig.md | 20 - .../docs/devbox_examples/servers/apache.md | 68 - .../app/docs/devbox_examples/servers/caddy.md | 66 - .../app/docs/devbox_examples/servers/nginx.md | 80 - .../app/docs/devbox_examples/stacks/django.md | 67 - .../app/docs/devbox_examples/stacks/drupal.md | 32 - .../app/docs/devbox_examples/stacks/jekyll.md | 26 - docs/app/docs/devbox_examples/stacks/lapp.md | 27 - .../docs/devbox_examples/stacks/laravel.md | 65 - docs/app/docs/devbox_examples/stacks/lepp.md | 49 - docs/app/docs/devbox_examples/stacks/rails.md | 36 - .../app/docs/devbox_examples/stacks/spring.md | 30 - docs/app/docs/devbox_global.md | 121 - docs/app/docs/env_variables.md | 33 - docs/app/docs/faq.md | 110 - docs/app/docs/guides/creating_plugins.md | 244 - docs/app/docs/guides/pinning_packages.md | 49 - .../docs/guides/platform_specific_packages.md | 73 - docs/app/docs/guides/plugins.md | 168 - docs/app/docs/guides/scripts.md | 88 - docs/app/docs/guides/secrets.md | 41 - docs/app/docs/guides/services.md | 92 - docs/app/docs/guides/using_flakes.md | 116 - docs/app/docs/ide_configuration/direnv.md | 116 - docs/app/docs/ide_configuration/eclipse.md | 53 - docs/app/docs/ide_configuration/vscode.md | 114 - docs/app/docs/ide_configuration/zed.md | 41 - docs/app/docs/index.md | 41 - docs/app/docs/installing_devbox.mdx | 140 - docs/app/docs/quickstart.mdx | 177 - docs/app/docs/telemetry.md | 34 - docs/app/docusaurus.config.js | 212 - docs/app/nixhub/get-a-package.api.mdx | 73 - docs/app/nixhub/index.mdx | 69 - .../nixhub/resolve-a-package-version.api.mdx | 72 - docs/app/nixhub/search-packages.api.mdx | 72 - docs/app/nixhub/sidebar.ts | 27 - docs/app/nixhub_sidebars.js | 23 - docs/app/package.json | 53 - docs/app/pnpm-lock.yaml | 14412 ---------------- docs/app/sidebars.js | 197 - docs/app/specs/nixhub.yaml | 264 - docs/app/src/css/custom.css | 185 - docs/app/src/pages/index.module.css | 43 - docs/app/static/.nojekyll | 0 docs/app/static/img/active_member.png | Bin 30746 -> 0 bytes docs/app/static/img/auth_page.png | Bin 1158932 -> 0 bytes docs/app/static/img/build-logs.jpeg | Bin 400338 -> 0 bytes docs/app/static/img/cloud.svg | 1 - docs/app/static/img/connection_parameters.png | Bin 128915 -> 0 bytes docs/app/static/img/create-project.png | Bin 1097166 -> 0 bytes docs/app/static/img/create_team_form.png | Bin 28522 -> 0 bytes docs/app/static/img/custom-domain-issued.png | Bin 119465 -> 0 bytes docs/app/static/img/custom-domain-unknown.png | Bin 127744 -> 0 bytes docs/app/static/img/custom-domain.png | Bin 123343 -> 0 bytes .../img/dashboard_create_new_devspace.png | Bin 1238144 -> 0 bytes docs/app/static/img/delete_member.png | Bin 38374 -> 0 bytes docs/app/static/img/deploy-in-progress.png | Bin 1123297 -> 0 bytes docs/app/static/img/deploy-success.png | Bin 105290 -> 0 bytes docs/app/static/img/devbox_cloud_browser.png | Bin 454626 -> 0 bytes docs/app/static/img/devbox_cloud_editor.png | Bin 413011 -> 0 bytes docs/app/static/img/devbox_docs_logo_dark.svg | 5 - .../app/static/img/devbox_docs_logo_light.svg | 5 - docs/app/static/img/devbox_global.svg | 1 - docs/app/static/img/devbox_logo_dark.svg | 4 - docs/app/static/img/devbox_logo_light.svg | 4 - docs/app/static/img/devbox_sh.png | Bin 225922 -> 0 bytes docs/app/static/img/devbox_symbol_dark.svg | 3 - docs/app/static/img/devbox_symbol_light.svg | 3 - docs/app/static/img/discord.svg | 1 - docs/app/static/img/eclipse_background_2.png | Bin 157262 -> 0 bytes docs/app/static/img/edit_secrets.png | Bin 120458 -> 0 bytes docs/app/static/img/enable-deployments.jpeg | Bin 170391 -> 0 bytes docs/app/static/img/favicon.ico | Bin 4414 -> 0 bytes docs/app/static/img/github-dark.svg | 11 - docs/app/static/img/github-light.svg | 10 - docs/app/static/img/invited_member.png | Bin 29898 -> 0 bytes docs/app/static/img/inviting_member.png | Bin 55981 -> 0 bytes docs/app/static/img/jetify-docs-logo-dark.svg | 15 - .../app/static/img/jetify-docs-logo-light.svg | 15 - docs/app/static/img/jetify-social-card.png | Bin 5259954 -> 0 bytes docs/app/static/img/jetify_auth.jpeg | Bin 111293 -> 0 bytes .../static/img/jetify_cloud_dashboard.jpeg | Bin 699921 -> 0 bytes .../app/static/img/jetpack_docs_logo_dark.svg | 23 - .../static/img/jetpack_docs_logo_light.svg | 23 - docs/app/static/img/jetpack_logo_dark.svg | 26 - docs/app/static/img/jetpack_logo_light.svg | 26 - docs/app/static/img/members_tab.png | Bin 128044 -> 0 bytes docs/app/static/img/newproject-tworepos.png | Bin 1157234 -> 0 bytes docs/app/static/img/newproject.png | Bin 1168274 -> 0 bytes docs/app/static/img/nix-term-dark.svg | 11 - docs/app/static/img/nix-term-light.svg | 10 - docs/app/static/img/nix_snowflake_dark.svg | 53 - docs/app/static/img/nix_snowflake_light.svg | 58 - docs/app/static/img/open-in-devspace.svg | 19 - docs/app/static/img/open_in_devbox.svg | 14 - docs/app/static/img/postgres-secrets.png | Bin 101420 -> 0 bytes docs/app/static/img/process-compose-tui.png | Bin 419136 -> 0 bytes docs/app/static/img/project-page.png | Bin 1158281 -> 0 bytes docs/app/static/img/runtime-logs.png | Bin 440811 -> 0 bytes docs/app/static/img/s3-secrets.png | Bin 58501 -> 0 bytes docs/app/static/img/secrets.gif | Bin 781884 -> 0 bytes docs/app/static/img/secrets_tab.png | Bin 143186 -> 0 bytes docs/app/static/img/shield_galaxy.svg | 23 - docs/app/static/img/shield_moon.svg | 13 - docs/app/static/img/shield_white.svg | 14 - docs/app/static/img/supabase-API.png | Bin 176575 -> 0 bytes docs/app/static/img/supabase-secrets.png | Bin 54263 -> 0 bytes docs/app/static/img/team_selector.png | Bin 47509 -> 0 bytes docs/app/static/img/upstash-secrets.png | Bin 65854 -> 0 bytes docs/app/static/img/upstash.png | Bin 137833 -> 0 bytes docs/app/tsconfig.json | 8 - docs/app/vercel.json | 3 - docs/launchpad.yaml | 11 - docs/nginx.conf | 19 - docs/translation/README-ko-KR.md | 153 - docs/translation/README-zh-CN.md | 154 - 232 files changed, 23289 deletions(-) delete mode 100644 docs/.dockerignore delete mode 100644 docs/.gitignore delete mode 100644 docs/.markdownlint.yaml delete mode 100644 docs/Dockerfile delete mode 100644 docs/README.md delete mode 100644 docs/app/.envrc delete mode 100644 docs/app/.gitignore delete mode 100644 docs/app/.yarnrc.yml delete mode 100644 docs/app/babel.config.js delete mode 100644 docs/app/cloud/_category_.json delete mode 100644 docs/app/cloud/cache/authenticating.md delete mode 100644 docs/app/cloud/cache/index.md delete mode 100644 docs/app/cloud/cache/prebuilt_cache.md delete mode 100644 docs/app/cloud/cache/usage.md delete mode 100644 docs/app/cloud/dashboard/_category_.json delete mode 100644 docs/app/cloud/dashboard/creating_your_team.md delete mode 100644 docs/app/cloud/dashboard/index.md delete mode 100644 docs/app/cloud/dashboard/inviting_members.md delete mode 100644 docs/app/cloud/deploys/_category_.json delete mode 100644 docs/app/cloud/deploys/custom_domains.md delete mode 100644 docs/app/cloud/deploys/index.md delete mode 100644 docs/app/cloud/deploys/integrations/_category_.json delete mode 100644 docs/app/cloud/deploys/integrations/index.md delete mode 100644 docs/app/cloud/deploys/integrations/s3.md delete mode 100644 docs/app/cloud/deploys/integrations/supabase.md delete mode 100644 docs/app/cloud/deploys/integrations/upstash.md delete mode 100644 docs/app/cloud/deploys/monitoring_deploys.md delete mode 100644 docs/app/cloud/deploys/secrets.md delete mode 100644 docs/app/cloud/deploys/setup.md delete mode 100644 docs/app/cloud/faq.md delete mode 100644 docs/app/cloud/index.md delete mode 100644 docs/app/cloud/secrets/_category_.json delete mode 100644 docs/app/cloud/secrets/dashboard_secrets.md delete mode 100644 docs/app/cloud/secrets/index.md delete mode 100644 docs/app/cloud/secrets/secrets_cli.md delete mode 100644 docs/app/cloud/sidebar.ts delete mode 100644 docs/app/cloud_sidebars.js delete mode 100644 docs/app/devbox.json delete mode 100644 docs/app/devbox.lock delete mode 100644 docs/app/docs/cli_reference/_category_.json delete mode 100644 docs/app/docs/cli_reference/devbox.md delete mode 100644 docs/app/docs/cli_reference/devbox_add.md delete mode 100644 docs/app/docs/cli_reference/devbox_cache.md delete mode 100644 docs/app/docs/cli_reference/devbox_cache_configure.md delete mode 100644 docs/app/docs/cli_reference/devbox_cache_info.md delete mode 100644 docs/app/docs/cli_reference/devbox_cache_upload.md delete mode 100644 docs/app/docs/cli_reference/devbox_completion.md delete mode 100644 docs/app/docs/cli_reference/devbox_completion_bash.md delete mode 100644 docs/app/docs/cli_reference/devbox_completion_fish.md delete mode 100644 docs/app/docs/cli_reference/devbox_completion_zsh.md delete mode 100644 docs/app/docs/cli_reference/devbox_create.md delete mode 100644 docs/app/docs/cli_reference/devbox_generate.md delete mode 100644 docs/app/docs/cli_reference/devbox_generate_devcontainer.md delete mode 100644 docs/app/docs/cli_reference/devbox_generate_direnv.md delete mode 100644 docs/app/docs/cli_reference/devbox_generate_dockerfile.md delete mode 100644 docs/app/docs/cli_reference/devbox_generate_readme.md delete mode 100644 docs/app/docs/cli_reference/devbox_global.md delete mode 100644 docs/app/docs/cli_reference/devbox_global_add.md delete mode 100644 docs/app/docs/cli_reference/devbox_global_install.md delete mode 100644 docs/app/docs/cli_reference/devbox_global_list.md delete mode 100644 docs/app/docs/cli_reference/devbox_global_pull.md delete mode 100644 docs/app/docs/cli_reference/devbox_global_push.md delete mode 100644 docs/app/docs/cli_reference/devbox_global_rm.md delete mode 100644 docs/app/docs/cli_reference/devbox_global_run.md delete mode 100644 docs/app/docs/cli_reference/devbox_global_services.md delete mode 100644 docs/app/docs/cli_reference/devbox_global_shellenv.md delete mode 100644 docs/app/docs/cli_reference/devbox_global_update.md delete mode 100644 docs/app/docs/cli_reference/devbox_info.md delete mode 100644 docs/app/docs/cli_reference/devbox_init.md delete mode 100644 docs/app/docs/cli_reference/devbox_install.md delete mode 100644 docs/app/docs/cli_reference/devbox_rm.md delete mode 100644 docs/app/docs/cli_reference/devbox_run.md delete mode 100644 docs/app/docs/cli_reference/devbox_search.md delete mode 100644 docs/app/docs/cli_reference/devbox_secrets.md delete mode 100644 docs/app/docs/cli_reference/devbox_secrets_download.md delete mode 100644 docs/app/docs/cli_reference/devbox_secrets_init.md delete mode 100644 docs/app/docs/cli_reference/devbox_secrets_list.md delete mode 100644 docs/app/docs/cli_reference/devbox_secrets_rm.md delete mode 100644 docs/app/docs/cli_reference/devbox_secrets_set.md delete mode 100644 docs/app/docs/cli_reference/devbox_secrets_upload.md delete mode 100644 docs/app/docs/cli_reference/devbox_services.md delete mode 100644 docs/app/docs/cli_reference/devbox_services_attach.md delete mode 100644 docs/app/docs/cli_reference/devbox_services_ls.md delete mode 100644 docs/app/docs/cli_reference/devbox_services_restart.md delete mode 100644 docs/app/docs/cli_reference/devbox_services_start.md delete mode 100644 docs/app/docs/cli_reference/devbox_services_stop.md delete mode 100644 docs/app/docs/cli_reference/devbox_services_up.md delete mode 100644 docs/app/docs/cli_reference/devbox_shell.md delete mode 100644 docs/app/docs/cli_reference/devbox_shellenv.md delete mode 100644 docs/app/docs/cli_reference/devbox_update.md delete mode 100644 docs/app/docs/cli_reference/devbox_version.md delete mode 100644 docs/app/docs/cli_reference/devbox_version_update.md delete mode 100644 docs/app/docs/configuration.md delete mode 100644 docs/app/docs/continuous_integration/github_action.md delete mode 100644 docs/app/docs/contributor-quickstart.md delete mode 100644 docs/app/docs/devbox_examples/databases/mariadb.md delete mode 100644 docs/app/docs/devbox_examples/databases/mongodb.md delete mode 100644 docs/app/docs/devbox_examples/databases/mysql.md delete mode 100644 docs/app/docs/devbox_examples/databases/postgres.md delete mode 100644 docs/app/docs/devbox_examples/databases/rabbitmq.md delete mode 100644 docs/app/docs/devbox_examples/databases/redis.md delete mode 100644 docs/app/docs/devbox_examples/databases/valkey.md delete mode 100644 docs/app/docs/devbox_examples/index.md delete mode 100644 docs/app/docs/devbox_examples/languages/csharp.md delete mode 100644 docs/app/docs/devbox_examples/languages/elixir.md delete mode 100644 docs/app/docs/devbox_examples/languages/fsharp.md delete mode 100644 docs/app/docs/devbox_examples/languages/go.md delete mode 100644 docs/app/docs/devbox_examples/languages/haskell.md delete mode 100644 docs/app/docs/devbox_examples/languages/java.md delete mode 100644 docs/app/docs/devbox_examples/languages/nim.md delete mode 100644 docs/app/docs/devbox_examples/languages/nodejs.md delete mode 100644 docs/app/docs/devbox_examples/languages/php.md delete mode 100644 docs/app/docs/devbox_examples/languages/python.md delete mode 100644 docs/app/docs/devbox_examples/languages/ruby.md delete mode 100644 docs/app/docs/devbox_examples/languages/rust.md delete mode 100644 docs/app/docs/devbox_examples/languages/zig.md delete mode 100644 docs/app/docs/devbox_examples/servers/apache.md delete mode 100644 docs/app/docs/devbox_examples/servers/caddy.md delete mode 100644 docs/app/docs/devbox_examples/servers/nginx.md delete mode 100644 docs/app/docs/devbox_examples/stacks/django.md delete mode 100644 docs/app/docs/devbox_examples/stacks/drupal.md delete mode 100644 docs/app/docs/devbox_examples/stacks/jekyll.md delete mode 100644 docs/app/docs/devbox_examples/stacks/lapp.md delete mode 100644 docs/app/docs/devbox_examples/stacks/laravel.md delete mode 100644 docs/app/docs/devbox_examples/stacks/lepp.md delete mode 100644 docs/app/docs/devbox_examples/stacks/rails.md delete mode 100644 docs/app/docs/devbox_examples/stacks/spring.md delete mode 100644 docs/app/docs/devbox_global.md delete mode 100644 docs/app/docs/env_variables.md delete mode 100644 docs/app/docs/faq.md delete mode 100644 docs/app/docs/guides/creating_plugins.md delete mode 100644 docs/app/docs/guides/pinning_packages.md delete mode 100644 docs/app/docs/guides/platform_specific_packages.md delete mode 100644 docs/app/docs/guides/plugins.md delete mode 100644 docs/app/docs/guides/scripts.md delete mode 100644 docs/app/docs/guides/secrets.md delete mode 100644 docs/app/docs/guides/services.md delete mode 100644 docs/app/docs/guides/using_flakes.md delete mode 100644 docs/app/docs/ide_configuration/direnv.md delete mode 100644 docs/app/docs/ide_configuration/eclipse.md delete mode 100644 docs/app/docs/ide_configuration/vscode.md delete mode 100644 docs/app/docs/ide_configuration/zed.md delete mode 100644 docs/app/docs/index.md delete mode 100644 docs/app/docs/installing_devbox.mdx delete mode 100644 docs/app/docs/quickstart.mdx delete mode 100644 docs/app/docs/telemetry.md delete mode 100644 docs/app/docusaurus.config.js delete mode 100644 docs/app/nixhub/get-a-package.api.mdx delete mode 100644 docs/app/nixhub/index.mdx delete mode 100644 docs/app/nixhub/resolve-a-package-version.api.mdx delete mode 100644 docs/app/nixhub/search-packages.api.mdx delete mode 100644 docs/app/nixhub/sidebar.ts delete mode 100644 docs/app/nixhub_sidebars.js delete mode 100644 docs/app/package.json delete mode 100644 docs/app/pnpm-lock.yaml delete mode 100644 docs/app/sidebars.js delete mode 100644 docs/app/specs/nixhub.yaml delete mode 100644 docs/app/src/css/custom.css delete mode 100644 docs/app/src/pages/index.module.css delete mode 100644 docs/app/static/.nojekyll delete mode 100644 docs/app/static/img/active_member.png delete mode 100644 docs/app/static/img/auth_page.png delete mode 100644 docs/app/static/img/build-logs.jpeg delete mode 100644 docs/app/static/img/cloud.svg delete mode 100644 docs/app/static/img/connection_parameters.png delete mode 100644 docs/app/static/img/create-project.png delete mode 100644 docs/app/static/img/create_team_form.png delete mode 100644 docs/app/static/img/custom-domain-issued.png delete mode 100644 docs/app/static/img/custom-domain-unknown.png delete mode 100644 docs/app/static/img/custom-domain.png delete mode 100644 docs/app/static/img/dashboard_create_new_devspace.png delete mode 100644 docs/app/static/img/delete_member.png delete mode 100644 docs/app/static/img/deploy-in-progress.png delete mode 100644 docs/app/static/img/deploy-success.png delete mode 100644 docs/app/static/img/devbox_cloud_browser.png delete mode 100644 docs/app/static/img/devbox_cloud_editor.png delete mode 100644 docs/app/static/img/devbox_docs_logo_dark.svg delete mode 100644 docs/app/static/img/devbox_docs_logo_light.svg delete mode 100644 docs/app/static/img/devbox_global.svg delete mode 100644 docs/app/static/img/devbox_logo_dark.svg delete mode 100644 docs/app/static/img/devbox_logo_light.svg delete mode 100644 docs/app/static/img/devbox_sh.png delete mode 100644 docs/app/static/img/devbox_symbol_dark.svg delete mode 100644 docs/app/static/img/devbox_symbol_light.svg delete mode 100644 docs/app/static/img/discord.svg delete mode 100644 docs/app/static/img/eclipse_background_2.png delete mode 100644 docs/app/static/img/edit_secrets.png delete mode 100644 docs/app/static/img/enable-deployments.jpeg delete mode 100644 docs/app/static/img/favicon.ico delete mode 100644 docs/app/static/img/github-dark.svg delete mode 100644 docs/app/static/img/github-light.svg delete mode 100644 docs/app/static/img/invited_member.png delete mode 100644 docs/app/static/img/inviting_member.png delete mode 100644 docs/app/static/img/jetify-docs-logo-dark.svg delete mode 100644 docs/app/static/img/jetify-docs-logo-light.svg delete mode 100644 docs/app/static/img/jetify-social-card.png delete mode 100644 docs/app/static/img/jetify_auth.jpeg delete mode 100644 docs/app/static/img/jetify_cloud_dashboard.jpeg delete mode 100644 docs/app/static/img/jetpack_docs_logo_dark.svg delete mode 100644 docs/app/static/img/jetpack_docs_logo_light.svg delete mode 100644 docs/app/static/img/jetpack_logo_dark.svg delete mode 100644 docs/app/static/img/jetpack_logo_light.svg delete mode 100644 docs/app/static/img/members_tab.png delete mode 100644 docs/app/static/img/newproject-tworepos.png delete mode 100644 docs/app/static/img/newproject.png delete mode 100644 docs/app/static/img/nix-term-dark.svg delete mode 100644 docs/app/static/img/nix-term-light.svg delete mode 100644 docs/app/static/img/nix_snowflake_dark.svg delete mode 100644 docs/app/static/img/nix_snowflake_light.svg delete mode 100644 docs/app/static/img/open-in-devspace.svg delete mode 100644 docs/app/static/img/open_in_devbox.svg delete mode 100644 docs/app/static/img/postgres-secrets.png delete mode 100644 docs/app/static/img/process-compose-tui.png delete mode 100644 docs/app/static/img/project-page.png delete mode 100644 docs/app/static/img/runtime-logs.png delete mode 100644 docs/app/static/img/s3-secrets.png delete mode 100644 docs/app/static/img/secrets.gif delete mode 100644 docs/app/static/img/secrets_tab.png delete mode 100644 docs/app/static/img/shield_galaxy.svg delete mode 100644 docs/app/static/img/shield_moon.svg delete mode 100644 docs/app/static/img/shield_white.svg delete mode 100644 docs/app/static/img/supabase-API.png delete mode 100644 docs/app/static/img/supabase-secrets.png delete mode 100644 docs/app/static/img/team_selector.png delete mode 100644 docs/app/static/img/upstash-secrets.png delete mode 100644 docs/app/static/img/upstash.png delete mode 100644 docs/app/tsconfig.json delete mode 100644 docs/app/vercel.json delete mode 100644 docs/launchpad.yaml delete mode 100644 docs/nginx.conf delete mode 100644 docs/translation/README-ko-KR.md delete mode 100644 docs/translation/README-zh-CN.md diff --git a/docs/.dockerignore b/docs/.dockerignore deleted file mode 100644 index 0079105294c..00000000000 --- a/docs/.dockerignore +++ /dev/null @@ -1,3 +0,0 @@ -app/build/Release -app/.docusaurus -app/node_modules diff --git a/docs/.gitignore b/docs/.gitignore deleted file mode 100644 index ca1b2625b19..00000000000 --- a/docs/.gitignore +++ /dev/null @@ -1,29 +0,0 @@ -# Dependencies -app/node_modules/ - -# Production -app/build/ - -# Generated files -app/.docusaurus/ -.cache-loader - -# Misc -.DS_Store -.env.local -.env.development.local -.env.test.local -.env.production.local - -npm-debug.log* -yarn-debug.log* -yarn-error.log* - -app/.yarn/* -!app/.yarn/patches -!app/.yarn/plugins -!app/.yarn/releases -!app/.yarn/sdks -!app/.yarn/versions -# If we want to start checking in the cache to enable 'zero install': -# !app/.yarn/cache diff --git a/docs/.markdownlint.yaml b/docs/.markdownlint.yaml deleted file mode 100644 index fb940393d6b..00000000000 --- a/docs/.markdownlint.yaml +++ /dev/null @@ -1,10 +0,0 @@ -# Autoformatter friendly markdownlint config (all formatting rules disabled) -default: true -blank_lines: false -bullet: false -html: false -indentation: false -line_length: false -spaces: false -url: false -whitespace: false diff --git a/docs/Dockerfile b/docs/Dockerfile deleted file mode 100644 index 9c26d5b115c..00000000000 --- a/docs/Dockerfile +++ /dev/null @@ -1,6 +0,0 @@ -# syntax=docker/dockerfile:1 -FROM nginx:stable-alpine as deploy -WORKDIR /app -EXPOSE 80 -COPY ./app/build/devbox/docs ./static/devbox/docs/ -COPY ./nginx.conf /etc/nginx/nginx.conf diff --git a/docs/README.md b/docs/README.md deleted file mode 100644 index 2cc294fe1de..00000000000 --- a/docs/README.md +++ /dev/null @@ -1,43 +0,0 @@ -# Website - -This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator. - - -## Installation - -```bash -cd docs/app # from the devbox root directory -devbox shell # optional, develop inside a devbox -pnpm install # run in devbox shell -``` - -### Local Development - -```bash -devbox run start -``` - -This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server. -NOTE: this will open localhost:3000/docs that will show a 404 Not Found. Go to localhost:3000/docs/devbox instead to find the real docs. - -### Build - -```bash -devbox run build -``` - -This command generates static content into the `build` directory and can be served using any static contents hosting service. - -### Deployment - -When a pull request is opened, it will automatically deploy via CICD to a preview. -When a pull request is merged, it will automatically deploy to production. -Check https://www.jetify.com/devbox/ after merge to see the latest changes. - -# Devbox Documentation - -Welcome to the Devbox documentation! This documentation is built using Docusaurus and contains all the information you need to get started with Devbox. - -## Contributing to Documentation - -We welcome contributions to our documentation! If you find any issues or would like to suggest improvements, please feel free to open a pull request. diff --git a/docs/app/.envrc b/docs/app/.envrc deleted file mode 100644 index eff60eb12cf..00000000000 --- a/docs/app/.envrc +++ /dev/null @@ -1,9 +0,0 @@ -#!/bin/bash - -# Automatically sets up your devbox environment whenever you cd into this -# directory via our direnv integration: - -eval "$(devbox generate direnv --print-envrc)" - -# check out https://www.jetify.com/docs/devbox/ide_configuration/direnv/ -# for more details diff --git a/docs/app/.gitignore b/docs/app/.gitignore deleted file mode 100644 index ed3fe720dcd..00000000000 --- a/docs/app/.gitignore +++ /dev/null @@ -1,21 +0,0 @@ -# Dependencies -/node_modules - -# Production -/build - -# Generated files -.docusaurus -.cache-loader - -# Misc -.DS_Store -.env.local -.env.development.local -.env.test.local -.env.production.local - -npm-debug.log* -yarn-debug.log* -yarn-error.log* -.vercel diff --git a/docs/app/.yarnrc.yml b/docs/app/.yarnrc.yml deleted file mode 100644 index 3186f3f0795..00000000000 --- a/docs/app/.yarnrc.yml +++ /dev/null @@ -1 +0,0 @@ -nodeLinker: node-modules diff --git a/docs/app/babel.config.js b/docs/app/babel.config.js deleted file mode 100644 index e00595dae7d..00000000000 --- a/docs/app/babel.config.js +++ /dev/null @@ -1,3 +0,0 @@ -module.exports = { - presets: [require.resolve('@docusaurus/core/lib/babel/preset')], -}; diff --git a/docs/app/cloud/_category_.json b/docs/app/cloud/_category_.json deleted file mode 100644 index 206b67e81f5..00000000000 --- a/docs/app/cloud/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "label": "Jetify Cloud", - "position": 3 -} \ No newline at end of file diff --git a/docs/app/cloud/cache/authenticating.md b/docs/app/cloud/cache/authenticating.md deleted file mode 100644 index fcfc2438a37..00000000000 --- a/docs/app/cloud/cache/authenticating.md +++ /dev/null @@ -1,63 +0,0 @@ ---- -title: Authenticating with the Cache -sidebar_position: 2 ---- - -Your Jetify Cloud organization is automatically provisioned with a shared cache. Any developers invited to your Jetify Cloud org will be automatically authenticated with the cache when they sign in. - -## Managing Access to the Cache - -Team members can be added in one of two Roles, which controls their access to the Jetify Build Cache. - -- **Members** have read-only access to the cache, and cannot push new packages -- **Admins** have full read/write access to the cache, and can push new packages. - -You can add or remove team members from your team, or modify their role, using the [Jetify Cloud Dashboard](../dashboard/inviting_members.md) - -## Authenticating from the CLI - -Once you’ve been invited to a team, you can authenticate from the CLI by running: - -```bash -devbox auth login -``` - -This will launch a browser window where you can authenticate with an email address or via Google SSO. - -You can check your current authentication status by running: - -```bash -devbox auth whoami -``` - -You can check that you are connected to the cache, and your current cache URL, by running: - -```bash -devbox cache info -``` - -You can logout by running: - -```bash -devbox auth logout -``` - -### Authenticating CI or Build Hosts - -Admin users can generate Personal Access Tokens to authenticate on hosts where you cannot login via the CLI or Browser. This token will have the same push/pull permissions as the account that generated it. - -:::warning -Treat your Personal Access Token as a password — keep it secret and secure, and do not share it with other users. -::: - -To generate a Token, first authenticate as described above, and then run: - -```bash -devbox auth tokens new -``` - -To authenticate with the personal access token, export it as an environment variable on your host: - -```bash -export DEVBOX_API_TOKEN= -``` diff --git a/docs/app/cloud/cache/index.md b/docs/app/cloud/cache/index.md deleted file mode 100644 index 13a706c68d4..00000000000 --- a/docs/app/cloud/cache/index.md +++ /dev/null @@ -1,23 +0,0 @@ ---- -title: Caching and Sharing Packages with Jetify -sidebar_position: 1 ---- - -The **Jetify Cache** provides teams with a private, secure Nix package cache that makes it easy to share packages across all your projects and users. With the Jetify cache, you never have to rebuild a package, even if it's removed from the official [Nix package cache](https://cache.nixos.org). - -:::info -If you want to use the Jetify Cache, you will need to add a payment option and upgrade your account to a Solo Plan or higher. For more details, see our [Plans and Pricing](https://www.jetify.com/cloud/pricing). -::: - -Jetify Cache provides the following features: - -* **Fast package installations**: Devbox is optimized for downloading and installing packages from the Jetify cache, and it can bypass costly Nix evaluation steps when installing your packages. -* **Integrates seamlessly with Devbox**: Devbox automatically configures access to the cache once users sign in, and packages are automatically pulled from the cache when running `devbox shell`, `devbox run`, or other commands. -* **Integrates with CI/CD**: Jetify Cache can generate a secure token for securely pushing and pulling packages in CI/CD. -* **Simple Access Control**: Devbox makes it easy to restrict which users can write to the cache, and makes it easy to revoke access directly from the dashboard. Jetify also supports Single Sign On for Enterprise Cache users - -## Guides - -- [Setting Up Jetify Cache](./authenticating.md) -- [Pushing and Pulling Packages from the Cache](./usage.md) -- [Using the Jetify Prebuilt Cache](./prebuilt_cache.md) diff --git a/docs/app/cloud/cache/prebuilt_cache.md b/docs/app/cloud/cache/prebuilt_cache.md deleted file mode 100644 index 943e86903e6..00000000000 --- a/docs/app/cloud/cache/prebuilt_cache.md +++ /dev/null @@ -1,36 +0,0 @@ ---- -title: Using the Jetify Prebuilt Cache ---- - -The Jetify Prebuilt Cache provides users with prebuilt binaries of popular packages for the most common OS(Linux, macOS) + Architecture (x86-64, aarch64) combinations. - -The Jetify Prebuilt cache is intended to supplement the official NixOS Cache, and includes packages which are not available by default. This includes: - -1. Older packages that have been garbage collected -2. Packages which have not been built for certain platforms -3. Packages with unfree licenses, which are not automatically built by NixOS - -## Using the Prebuilt Cache - -The Prebuilt Cache is available for free to every developer who signs up for a Jetify Cloud account. Devbox will automatically configure itself to use the Prebuilt Cache when you login with `devbox auth login`: no additional action or steps are required. - -:::info -Free Jetify Cloud accounts are restricted to a **25 GB per month** download limit, and cannot generate access tokens for the cache. - -Solo, Starter, and Scaleup accounts have unlimited access to the Prebuilt Cache. -::: - -## Packages included in the Prebuilt Cache - -Some of the packages included in the Prebuilt Cache are: - -* MongoDB -* Terraform -* Vault -* DynamoDB local -* Pulumi -* Helm -* Unrar -* Graphite - -More packages are added regularly. If you encounter a package that you think should be in the Prebuilt Cache, notify us on our [Discord](https://discord.gg/jetify). \ No newline at end of file diff --git a/docs/app/cloud/cache/usage.md b/docs/app/cloud/cache/usage.md deleted file mode 100644 index d432a793ab8..00000000000 --- a/docs/app/cloud/cache/usage.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: Pushing and Pulling Packages to the Cache -sidebar_position: 3 ---- -## Pulling Packages from the Cache - -Once you have authenticated, Devbox will automatically configure your cache for you. You can also manually configure the cache by running: - -```bash -devbox cache configure -``` - -Once configured, Devbox will attempt to use the cache whenever you run a command that prompts Devbox to install a package in your project. When installing a package, Devbox will check for a cached binary in the following locations: - -1. Your local Nix Store `/nix/store` -2. The Jetify Cache -3. The Public Nix Cache ([cache.nixos.org](https://cache.nixos.org)) - -If the package is not available in those locations, then it will build the package from source. - -## Pushing to the Cache - -You can push custom packages and project closures to your Jetify Cache directly from the Devbox CLI. Push access is currently only available for authenticated users with Admin permissions. - -### **Pushing a Devbox Project** - -You can push the entire closure of a Devbox project to the Jetify Cache by navigating to your project root and running - -```bash -devbox cache upload -``` - -### Pushing a specific package - -You can also push a single package by passing a flake reference to the Devbox CLI. - -For example, to push a custom `mongodb` package from a custom flake.nix on your machine, you can run: - -```bash -devbox cache upload path:./path/to/flake.nix#mongodb -``` - -You can also cache packages from Github or from Nixpkgs by passing the appropriate Flake reference. This can be useful for caching build artifacts if a package does not exist in the public Nix cache, or if it requires you to build it from source: - -```bash -# Cache an installable hosted on Github (process-compose) -devbox cache upload github:F1bonnac1/process-compose - -# Cache a package from nixpkgs -devbox cache upload nixpkgs#mongodb -``` \ No newline at end of file diff --git a/docs/app/cloud/dashboard/_category_.json b/docs/app/cloud/dashboard/_category_.json deleted file mode 100644 index 5d12ee7bb4b..00000000000 --- a/docs/app/cloud/dashboard/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "label": "Dashboard", - "position": 3 -} \ No newline at end of file diff --git a/docs/app/cloud/dashboard/creating_your_team.md b/docs/app/cloud/dashboard/creating_your_team.md deleted file mode 100644 index 2727be1081d..00000000000 --- a/docs/app/cloud/dashboard/creating_your_team.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Creating Your Team -sidebar_position: 2 ---- - -Developers who want to use Jetify for their personal projects can sign up for a free account. The free account comes with basic Jetify Cloud features (like Secrets), with additional features like Deployments and Cache available for purchase. - -If you want to collaborate and share your projects with other members on your team, you will need to upgrade to a **Team Account**. Team accounts let you invite other developers to share resources and collaborate on projects in Jetify Cloud. - -Users with a free account can upgrade to a paid team on the dashboard anytime. - -## Creating a New Team Account - -1. From the Team Selector in the top right of your dashboard, select **Create a New Team** - -![New Team](../../static/img/team_selector.png) - -1. You may be prompted to sign in again. Log in with the same email or Google Account that you used to create your Account. - -1. At the bottom of the team selection screen, enter your new Team Name and then click **Create Team** - -![Create Team Form](../../static/img/create_team_form.png) - -1. Your new team will be created, and you will be automatically switched to your new team. You can now [invite other members](./inviting_members.md) to join your team. - -## Billing - -Free accounts are free forever. You will need to add a payment method to unlock paid tier features. - -Team accounts are billed monthly based on the number of active members in your team. You can view your current billing status and update your billing information from the **Billing** tab in the Jetify Dashboard. diff --git a/docs/app/cloud/dashboard/index.md b/docs/app/cloud/dashboard/index.md deleted file mode 100644 index 1a9ecad3249..00000000000 --- a/docs/app/cloud/dashboard/index.md +++ /dev/null @@ -1,16 +0,0 @@ ---- -title: Introduction -sidebar_position: 1 ---- - -The [Jetify Dashboard](https://cloud.jetify.com) lets you manage your team, projects, and secrets from a single interface. You can use the Dashboard to manage your own hobby projects, or to collaborate with other team members. - -![Jetify Dashboard](../../static/img/jetify_cloud_dashboard.jpeg) - -You can visit the Jetify Dashboard at [cloud.jetify.com](https://cloud.jetify.com) - -## Guides - -- [Creating Your Team](./creating_your_team.md) -- [Inviting Members](./inviting_members.md) -- [Managing Jetify Secrets from the Dashboard](../secrets/dashboard_secrets.md) diff --git a/docs/app/cloud/dashboard/inviting_members.md b/docs/app/cloud/dashboard/inviting_members.md deleted file mode 100644 index 5631e45a0c1..00000000000 --- a/docs/app/cloud/dashboard/inviting_members.md +++ /dev/null @@ -1,47 +0,0 @@ ---- -title: Inviting your Team Members -sidebar_position: 3 ---- - -If you have a paid Team project, you can invite team members to join your project. Team members can configure and use your project’s secrets when developing using the Devbox or Envsec CLI. - -:::info -If you want to invite team members to your projects, you will need to add a payment option and upgrade your account to a Starter Plan. For more details, see our [Plans and Pricing](https://www.jetify.com/cloud/pricing). -::: - -Team members can be added in one of two Roles: - -- **Member:** Members can access or add projects, as well as access or modify the secrets for their projects -- **Admins:** Have all the permissions of Members, but can also invite new team members and configure project billing - -## Adding a Team Member - -1. In the Jetify Dashboard, navigate to the **Members** tab - - ![Members Tab](../../static/img/members_tab.png) - -2 . To invite a member, enter their email address, and the **Role** you want to assign to them. - -![Inviting a Member](../../static/img/inviting_member.png) - -1. Once invited, users will receive an email with instructions on how to join your team. They will show up in the **Members** tab as invited until they accept the invitation: - - ![Invited Member](../../static/img/invited_member.png) - - Note that invitations will expire if they are not accepted within 7 days, after which you will need to re-send the invitation. - - Once they accept the invitation, they will switch to **active** - - ![Active Member](../../static/img/active_member.png) - -## Removing a Team Member - -Removing a team member will remove their access to all projects and secrets in your team. To remove a team member - -1. Navigate to the Members tab on the Jetify Dashboard -2. Click the Options button to the right of the the member’s name -3. Select Delete from the pop up that appears: - -![Delete a member](../../static/img/delete_member.png) - -1. Click **OK** on the confirmation window that appears to confirm that you want to remove the member from your team diff --git a/docs/app/cloud/deploys/_category_.json b/docs/app/cloud/deploys/_category_.json deleted file mode 100644 index 24bc38558f2..00000000000 --- a/docs/app/cloud/deploys/_category_.json +++ /dev/null @@ -1,5 +0,0 @@ -{ - "label": "Deployments", - "position": 4 - -} \ No newline at end of file diff --git a/docs/app/cloud/deploys/custom_domains.md b/docs/app/cloud/deploys/custom_domains.md deleted file mode 100644 index 710624f2f94..00000000000 --- a/docs/app/cloud/deploys/custom_domains.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -title: Setting a Custom Domain for your Project -sidebar_position: 5 ---- - -Jetify Cloud will automatically configure a unique, private domain for previewing your deployed application. For production purposes, you will probably want to add a more user friendly domain to route users to your application. Jetify will also configure and issue an SSL certificate for your domain automatically. - -:::info - -You will need access to the DNS records for your Domain in order to configure it for Jetify Cloud. - -::: - -## Adding a Custom Domain - -1. In your project on the Jetify Cloud Dashboard, select **Settings** -1. Scroll down to the **Custom Domain** section on the settings page - ![Custom Domain Section](../../static/img/custom-domain.png) -1. Enter the custom domain name that you would like to use for your project -1. After you click confirm, your custom domain will be set in a pending state. To validate the domain, you will need to add a record to your DNS provider: - ![Pending custom domain](../../static/img/custom-domain-unknown.png) -1. Once the correct records have been added to your DNS provider, your Custom Domain will display an **Issued** status: - ![Custom Domain Issued](../../static/img/custom-domain-issued.png) - -## Removing a Custom Domain - -You can remove a custom domain by clicking the Delete button. This will remove the domain from your project. Note that after removing the domain, you may want to also clean up your DNS records. diff --git a/docs/app/cloud/deploys/index.md b/docs/app/cloud/deploys/index.md deleted file mode 100644 index f6a0cad9d99..00000000000 --- a/docs/app/cloud/deploys/index.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -title: "Introduction" -sidebar_position: 1 ---- - -Jetify Deployments is an easy, Devbox friendly way to deploy a stateless application to the cloud in a few minutes. Jetify can build and run any Docker container, and provides easy tools for configuring your project's secrets, custom domains, and more. Jetify connects to your projects Github repo to ensure that you always have the latest version of your application deployed. - -:::info -If you want to invite team members to your projects, you will need to add a payment option and upgrade your account to a Solo Plan or higher. For more details, see our [Plans and Pricing](https://www.jetify.com/cloud/pricing). -::: - -## Quickstart - -This quickstart will walk through how to configure and deploy a project with Jetify Cloud. We'll start by forking an example repo that is configured for Jetify Deployments, and then demonstrate how to connect your Github repo and activate deploys for your account. - -## Forking the Example Repo - -To help you get started with Jetify Cloud, we've created an [example Rails app](https://github.com/jetify-com/jetify-deploy-example) that's been configured to deploy with Jetify Cloud. - -You can fork this repo from the Github UI to add it to your account, or clone and push the repo to your Github account. - -## Connecting your Repo to Jetify Cloud - -First, you'll need to sign-in with Github and connect your project to Jetify Cloud: - -1. From the Create Project screen, select Continue with Github to sign in with Github -2. Select a Github Org to import your project from. If you are only a member of one org, it will be selected for you by default. - 1. If this is your first time importing a project from your org, you will need to install the Devbox Cloud app to provide access to your project -3. Select a Repository to import your repo. If your project is not in the root directory of your repository, you can specify a subdirectory for Jetify to search for your project. - -Once your project is added to Jetify Cloud, you can configure your secrets or deployments. - -## Deploying your Site - -1. Select the Deploys tab in your project -2. Click the **Enable Deployments** button to turn on Jetify Deployments for your project -3. Once activated, Jetify will automatically attempt to deploy your repository. You can select the deployment to view its status and build logs - -If your site fails to deploy, or if you want to update your deployment, push a commit to the default branch of your repo to trigger a new deploy. - -## Visiting your Site - -When your site has finished deploying, Jetify Cloud will display a preview URL that you can visit to test your application. - -Congratulations! You've now deployed your first site with Jetify Cloud. - -## Next Steps - -* Learn more about [setting up your project](./setup.md) -* Set up a [custom domain](./custom_domains.md) for your application -* Learn how to setup databases, caches, and other [integrations](./integrations/index.md) diff --git a/docs/app/cloud/deploys/integrations/_category_.json b/docs/app/cloud/deploys/integrations/_category_.json deleted file mode 100644 index bb7a130aca5..00000000000 --- a/docs/app/cloud/deploys/integrations/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "label": "Integrations", - "position": 5 -} \ No newline at end of file diff --git a/docs/app/cloud/deploys/integrations/index.md b/docs/app/cloud/deploys/integrations/index.md deleted file mode 100644 index 3528d06bba4..00000000000 --- a/docs/app/cloud/deploys/integrations/index.md +++ /dev/null @@ -1,9 +0,0 @@ ---- -title: Integration Guides ---- - -This section contains guides on how to integrate common services with your Jetify deployments. - -* [PostgresQL with Supabase](./supabase.md) -* [Redis with Upstash](./upstash.md) -* [Object Storage with S3](./s3.md) \ No newline at end of file diff --git a/docs/app/cloud/deploys/integrations/s3.md b/docs/app/cloud/deploys/integrations/s3.md deleted file mode 100644 index d215ad0eb9b..00000000000 --- a/docs/app/cloud/deploys/integrations/s3.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Object Storage with AWS S3 ---- - -[Amazon S3](https://aws.amazon.com/s3/) is an industry leading cloud object storage solution. You can use S3 to store files, media assets, and other objects that are not well suited to storage in a database or KV store. - -You can view an example of this integration on [Github](https://github.com/jetify-com/jetify-deploy-integration/tree/main/devbox-json/s3) - -## Setting up S3 - -If you don't already have an S3 bucket configured, you will need an [AWS account](https://docs.aws.amazon.com/SetUp/latest/UserGuide/setup-overview.html) + IAM user with access to your S3 buckets. Once your account is setup, you can create an S3 Bucket using the following steps: - -1. From the **Services** selector in your AWS Console, select **Storage**, then **S3** -2. On the S3 Dashboard, click **Create Bucket**, and give your bucket a name and default region -3. If your files do not need to be accessed by external, public users, leave the **Block all Public Access** button checked. Otherwise configure the permissions to match your needs -4. Once you've finished configuring the bucket, click **Create Bucket** -5. Copy the ARN and save it somewhere secure. - -Once the bucket is created, you'll also need to configure [Bucket Access Policies](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html) and an [IAM User Policy](https://docs.aws.amazon.com/AmazonS3/latest/userguide/walkthrough1.html) to allow your user to securely access the bucket. Consult the S3 documentation for more details on how to configure the correct policy for your needs. - -## Connecting Jetify Cloud to your S3 Account - -If you want your Jetify Cloud App to push and pull objects from your S3 Bucket, you can use Jetify Secrets to set your AWS Access Key ID and Secret in your environment: - -* Go to the Jetify Dashboard for your project, and navigate to Secrets. Create the following Secrets in the `Prod` environment: - * `AWS_ACCESS_KEY_ID`: The access key for your AWS account - * `AWS_SECRET_ACCESS_KEY`: The secret key for your AWS account - * `AWS_BUCKET`: The name of the bucket that you will be accessing. - -![S3 Jetify Secrets](../../../static/img/s3-secrets.png) - -When you deploy your application, Devbox will automatically set these secrets as env variables in your environment. You can use these secrets with any AWS client library (such as boto3 for Python) or via the AWS CLI/SDK itself. diff --git a/docs/app/cloud/deploys/integrations/supabase.md b/docs/app/cloud/deploys/integrations/supabase.md deleted file mode 100644 index 21b349040ba..00000000000 --- a/docs/app/cloud/deploys/integrations/supabase.md +++ /dev/null @@ -1,66 +0,0 @@ ---- -title: PostgreSQL with Supabase -sidebar_position: 5 ---- - -[Supabase](https://supabase.com) is an open source Firebase alternative that provides a managed, highly scalable PostgreSQL database and other infrastructure APIs that can support stateless and serverless applications. Supabase is easy to connect to using either the Supabase API, or standard PostgreSQL connection parameters. - -You can view an example of this integration on [Github](https://github.com/jetify-com/jetify-deploy-integration/tree/main/devbox-json/supabase) - -## Setting up Supabase - -If you don't have one already, you will first need to create an organization and project in Supabase to use with Jetify Cloud. If you are just testing Supabase with Jetify, you can create a free personal organization to start. For more details, see the [Supabase Docs](https://supabase.com/docs) - -If you plan to connect using PostgreSQL connection parameters, make sure that you save your Database password at creation time since you may need it to connect. - -## Connecting using the Supabase API or Clients - -The simplest way to connect to Supabase is via the API or one of Supabase's client libraries. Connecting via the API also lets you use Supabase's advanced realtime and streaming features. - -To connect using the API: - -* From your Supabase Project Dashboard, navigate to **Project Settings**, then **API** -* In the API Settings pane, copy the Project URL and Secret Service Role key -![Supabase API UI](../../../static/img/supabase-API.png) -* Go to the Jetify Dashboard for your project, and navigate to Secrets. Create the following Secrets in the `Prod` environment: - * `SUPABASE_URL`: the Project URL for your Supabase DB - * `SUPABASE_KEY`: the secret Service Role Key - -:::info - If you want to use your Database locally or in a preview environment, you can also set these environment variables for the `dev` and `preview` environment -::: - -![Secrets set in the Jetify Cloud](../../../static/img/supabase-secrets.png) - -When you deploy your application, Devbox will automatically set these secrets as env variables in your environment. You can use these environment variables when configuring your Supabase client. - -For example, if you are connecting from a Python app, you can do something like the following to connect with the Supabase Python client: - -```python -from supabase import create_client, Client - -url: str = os.getenv('SUPABASE_URL') -key: str = os.getenv('SUPABASE_KEY') - -supabase: Client = create_client(url, key) -``` - -## Connecting via PostgreSQL Connection Parameters - -You can also connect to your database using the standard PostgreSQL Database connection parameters. This is useful if your project cannot use the Supabase API, or if it requires a standard PostgreSQL connection - -To connect via PostgreSQL: - -* From your Supabase Project Dashboard, navigate to Project Settings, then Database. -* In the Connection Parameters Settings, copy values needed for connection. Your database password will be the password you set when creating your project. -![Supabase Connection Parameters](../../../static/img/connection_parameters.png) - -* Go to the Jetify Dashboard for your project, and navigate to Secrets. Create the following Secrets in the `Prod` environment: - * `POSTGRES_HOST`: Your PostgreSQL Host - * `POSTGRES_PORT`: Your PostgreSQL DB Port - * `POSTGRES_USER`: Your PostgreSQL Username - * `POSTGRES_PASSWORD`: Your PostgreSQL Database Password - -![Postgres Secrets](../../../static/img/postgres-secrets.png) - -When you deploy your application, Devbox will automatically set these secrets as env variables in your environment. You can use these environment variables when configuring your PostgreSQL client or connection. diff --git a/docs/app/cloud/deploys/integrations/upstash.md b/docs/app/cloud/deploys/integrations/upstash.md deleted file mode 100644 index 8e31f13e81d..00000000000 --- a/docs/app/cloud/deploys/integrations/upstash.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -title: Redis with Upstash -sidebar_position: 6 ---- - -[Upstash](https://upstash.com) provides a managed Key-value store that is compatible with the Redis API. You can use Upstash Redis as a cache or key-value store for serverless or stateless deployments like Jetify Cloud. For more information, consult the [Upstash Docs](https://upstash.com/docs/introduction) - -You can view an example of this integration on [Github](https://github.com/jetify-com/jetify-deploy-integration/tree/main/devbox-json/upstash) - -## Using Upstash Redis with Jetify Cloud - -* [Create a Redis Database](https://upstash.com/docs/redis/overall/getstarted) in Upstash. Select the Database's name and region, and then click the Create button - * If you don't already have an Upstash account, you can create a free one to test with Jetify Cloud -* After clicking the Create button, you'll see a page with the connection details for your Database. Copy the Endpoint, Password, and Port -- you'll need these to connect from Jetify Cloud. - -![Upstash Dashboard after clicking Create](../../../static/img/upstash.png) - -* Go to the Jetify Dashboard for your project, and navigate to Secrets. Create the following Secrets in the `Prod` environment: - * `REDIS_HOST`: your Upstash DB Endpoint URL - * `REDIS_PASSWORD`: your Upstash DB Password - * `REDIS_PORT`: your Upstash DB Port - -:::info - If you want to use your Database locally or in a preview environment, you can also set these environment variables for the `dev` and `preview` environment -::: - -![Secrets set in the Jetify Cloud](../../../static/img/upstash-secrets.png) - -When you deploy your application, Devbox will automatically set these secrets as env variables in your environment. You can then access them using any redis client. - -For example, if you are connecting from a Python app, you can do something like the following to connect from a Redis client. - -```python -import os -import redis - -redis_cache = redis.StrictRedis( - host=os.getenv('REDIS_HOST'), - password=os.getenv('REDIS_PASSWORD'), - port=os.getenv('REDIS_PORT'), - ssl=True -) -``` diff --git a/docs/app/cloud/deploys/monitoring_deploys.md b/docs/app/cloud/deploys/monitoring_deploys.md deleted file mode 100644 index eaaf702d393..00000000000 --- a/docs/app/cloud/deploys/monitoring_deploys.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -title: Monitoring Your Deployments -sidebar_position: 3 ---- - -Jetify Cloud automatically provides build and runtime logs for each of your deployments in the Jetify Dashboard. - -## Build Logs - -Build logs include all the logs generated when cloning, building, and uploading your project to Jetify's Docker Registry. You can check the build logs to see why a build or deployment failed, or to identify bottlenecks in the build process. Build logs automatically stream in realtime. - -You can view the build logs for a specific deployment by selecting the deployment, and then expanding the Build logs section - -![Build logs](../../static/img/deploy-in-progress.png) - -## Runtime Logs - -Runtime logs capture everything that has happened in your application after it is deployed to the Jetify Cloud. You can use these logs to for testing and debugging server-side errors, or for understanding why a given deployment has failed to start. - -Runtime logs stream in realtime, and Devbox retains the last 24 hours of runtime logs for each of your deployments. - -You can view your Runtime Logs by clicking the **Runtime Logs** tab in your Deployment Details page: - -![Runtime Logs](../../static/img/runtime-logs.png) - -## Preview URL - -In addition to build and runtime logs, Jetify Cloud automatically generates a randomized preview URL that you can use to test your application, or to share a preview of the deployment with other users and developers. Each deployment receives a unique preview URL. - -To preview your deployment, click the **View** button on the Deployment Details page. diff --git a/docs/app/cloud/deploys/secrets.md b/docs/app/cloud/deploys/secrets.md deleted file mode 100644 index 0f19bcd9910..00000000000 --- a/docs/app/cloud/deploys/secrets.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -title: Using Jetify Secrets with your Deployment -sidebar_position: 4 ---- - -Projects deployed with Jetify Cloud are automatically configured to use [Jetify Secrets](../secrets/index.md) when deploying your project. You do not need to authenticate, or add any additional configuration to use your secrets. Your project will deploy using the `prod` environment for your secrets by default. - -For more details on how to configure secrets, see: - -* [Jetify Secrets Overview](../secrets/index.md) -* [Setting Secrets from the CLI](../secrets/secrets_cli.md) -* [Setting Secrets from the Dashboard](../secrets/dashboard_secrets.md) - diff --git a/docs/app/cloud/deploys/setup.md b/docs/app/cloud/deploys/setup.md deleted file mode 100644 index 02865160267..00000000000 --- a/docs/app/cloud/deploys/setup.md +++ /dev/null @@ -1,77 +0,0 @@ ---- -title: Setting Up Your Deployment -sidebar_position: 2 ---- - -## Configuring your Project - -Deploying a project with Jetify Cloud requires the following: - -1. **A devbox.json or Dockerfile**: If your project contains a `devbox.json` file, devbox will automatically generate a Dockerfile that can be used to deploy your application to Jetify Cloud. You can also check in a custom Dockerfile if you want to precisely control how your project is built -2. **A Service Listening on 8080**. Jetify automatically forwards requests to port 8080 on your running container, so you will need to ensure that your service is listening to that port. We also recommend setting your service host to `0.0.0.0`. - -### Deploying with a devbox.json - -Jetify Cloud can use your `devbox.json` to generate a Docker container that will install your project dependencies and run your projects. In addition to installing your packages, Jetify will also look for and attempt to run any `install`, `build`, and `start` scripts defined in your devbox.json: - -- The **install script** will run after your base container has been initialized and your Nix packages are installed. This stage should be used to download and build your application's dependencies -- The **build script** runs after the install stage, and should be used to build or bundle your application. -- The **start script** will run as your container's entrypoint. This stage should include any commands needed to start and run your application. - -Below is an example `devbox.json` that can be used for a simple Go project in Jetify Cloud: - -```json -{ - "packages": [ - "go@1.19.8" - ], - "env": { - "GOPATH": "$HOME/go/", - "PATH": "$PATH:$HOME/go/bin" - }, - "shell": { - "init_hook": [ - "export \"GOROOT=$(go env GOROOT)\"" - ], - "scripts": { - "install": "go get ./...", - "build": "go build -o main.go", - "start": "go run", - "run_test": "go run main.go" - } - } -} -``` - -In this case, Jetify Cloud will first install Devbox and all the packages, then run the `install` and `build` scripts (in that order), and the use `start` as the entrypoint to the application. - -You can preview how Jetify will run the project using `devbox generate dockerfile --for prod` - -### Deploying with a Custom Dockerfile - -If your repo contains a Dockerfile, Jetify Cloud will use that Dockerfile to deploy your service (even if the project also contains a devbox.json). Your Dockerfile should define an entrypoint that Jetify can run upon deploying, as well as listen on port 8080. - -## Connecting your Repo - -Jetify requires you to connect a Github repo in order to deploy your service. To access private repositories, you will need to install the Devbox Cloud Github app in your repository: - -1. From the Create Project screen, select Continue with Github to sign in with Github -2. Select a Github Org to import your project from. If you are only a member of one org, it will be selected for you by default. - 1. If this is your first time importing a project from your org, you will need to install the Devbox Cloud app to provide access to your project -3. Select a Repository to import your repo. If your project is not in the root directory of your repository, you can specify a subdirectory for Jetify to search for your project. - -![Select the Repo for your Jetify Project](../../static/img/newproject-tworepos.png) - -## Choosing an Instance Size - -Jetify will default your deployment to the smallest instance size (0.1 CPU + 512MB RAM). To choose a different size: - -1. Navigate to the **Settings** tab of your project -2. Scroll down to **Deployments** -3. Choose the Machine configuration that best matches your project's needs. - -Changes to your instance size will take effect on the next deployment. - -## Deleting your Project - -If you no longer want to deploy your project with Jetify Deploys, you can disable deployments in the Settings tab of your project. diff --git a/docs/app/cloud/faq.md b/docs/app/cloud/faq.md deleted file mode 100644 index 555cdf3811d..00000000000 --- a/docs/app/cloud/faq.md +++ /dev/null @@ -1,56 +0,0 @@ ---- -title: Frequently Asked Questions -description: Frequently Asked Questions about Jetify Cloud ---- - -This doc contains answers to frequently asked questions about Jetify Cloud that are not covered elsewhere in our documentation. If you have a question that isn't covered here, feel free to ask us on our [Discord](https://discord.gg/jetify) - -## Do I have to pay to use Jetify Cloud? - -Jetify accounts are free for individual developers, and includes access to Jetify Secrets and the Jetify Prebuilt Cache. - -Using Jetify with a team requires a paid Jetify Solo, Starter, or Scale-up account. For details on other plans and limits, see our [**pricing**](https://www.jetify.com/cloud/pricing) page. - -## How can I share my Jetify Cloud project with other developers? - -To share secrets and access to deployments with other team members, you will need to create a new Jetify Starter Team and then invite developers to join your team. See the [cloud dashboard docs](./dashboard/creating_your_team.md) for more details. - -## How do Jetify Cloud Plans work? - -Jetify Cloud Plans are available for a monthly platform fee, and allow you to share your Jetify Cloud resources with your team, along with increased support levels. All plans include usage credits equal to the monthly platform fee, which are billed at standard usage rates. - -For more details, see our [**pricing**](https://www.jetify.com/cloud/pricing) page. - -## Do you offer self-hosted or private instances of Jetify Cloud? - -We offer private instances and other features as part of our Enterprise Plan. [Contact us](https://calendly.com/d/3rd-bhp-qym/meet-with-the-jetify-team) so we can build a solution that meets your needs. - - - - -## How does pricing for Jetify Cache work? - -The Jetify Prebuilt Cache is included in your subscription for no additional cost. - -Jetify Private Cache costs $0.60/GB of storage per month for the first 50 GB, and $0.50/GB per month after that. Jetify Private cache does not charge for bandwidth or downloads. - - - -## My project needs a custom instance size or scaling policy - -We can customize Jetify Deployments for your project's needs. [Contact us](https://calendly.com/d/3rd-bhp-qym/meet-with-the-jetify-team) for help with a customized solution. diff --git a/docs/app/cloud/index.md b/docs/app/cloud/index.md deleted file mode 100644 index d783aebfddb..00000000000 --- a/docs/app/cloud/index.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -title: Introduction -sidebar_position: 1 -hide_title: true ---- - -## Cloud Documentation - -[Jetify Cloud](https://cloud.jetify.com) gives your team the tools and frameworks to accelerate your -development workflow. Jetify Cloud is built on top of -[Devbox](https://www.jetify.com/devbox), a powerful tool for spinning up -reproducible, isolated development environments on any machine. - -:::info -Jetify Cloud is currently available in Early Access. We're actively working on adding new features and improving the platform. To learn more, share your feedback, or follow our progress, join our [Discord Channel](https://discord.gg/jetify). -::: - -Jetify Cloud currently includes: - -**[Jetify Cache](./cache/index.md)**: Provides a secure, private cache to share packages across all your Devbox projects and environments, whether sourced from Nixpkgs or Flakes. Avoid rebuilding custom packages locally or in CI. - -**[Jetify Secrets](./secrets/index.md)**: Securely store secrets and variables for all of your environments, and automatically synchronize them with your Devbox Shells and Scripts. - - - -More features are coming soon, keep an eye on our [**blog**](https://www.jetify.com/blog) for future updates! - -## Getting Started - -- Speed up your dev environments with [**Jetify Cache**](./cache/index.md) -- Integrate Secrets with your Devbox project using [**Jetify Secrets**](./secrets/index.md) -- Learn how to [**create your team**](./dashboard/creating_your_team.md) and [**invite members**](./dashboard/inviting_members.md) diff --git a/docs/app/cloud/secrets/_category_.json b/docs/app/cloud/secrets/_category_.json deleted file mode 100644 index c5888a77a73..00000000000 --- a/docs/app/cloud/secrets/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "label": "Secrets", - "position": 3 -} \ No newline at end of file diff --git a/docs/app/cloud/secrets/dashboard_secrets.md b/docs/app/cloud/secrets/dashboard_secrets.md deleted file mode 100644 index 9a440ed8de2..00000000000 --- a/docs/app/cloud/secrets/dashboard_secrets.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -title: Managing Secrets from the Dashboard -sidebar_position: 2 ---- - -You can add or manage secrets for a Jetify Cloud project using the Secrets tab of the Jetify Dashboard. Secrets that you set in the Dashboard will be automatically available when an authenticated member of your team uses Devbox to start a shell, script, or service in the application. - -## Prerequisites - -To manage secrets from the Jetify Cloud Dashboard, you must first: - -1. Add the project to your Jetify Cloud account -2. Initialize the project to use Jetify Secrets - -## Adding a Secret - -1. From the Jetify Dashboard, select the project whose secrets you want to manage -1. Navigate to the Secrets tab of the Jetify Dashboard - ![Jetify Dashboard Secrets Tab](../../static/img/secrets_tab.png) -1. To create a new secret, enter the key name of the secret, along with the value that you want to set in the form. Note that secrets are set as environment variables, so the key name must be a valid environment variable name. -1. You can also use the Environment checkboxes to set the secret for a specific environment. By default, secrets are set for the `Development` environment, but you can also set secrets for a `Preview` and `Prod` environment. -1. To add multiple secrets at one time, click the **Add Another** button -1. When you are finished adding secrets, click the **Submit** button - -## Updating and Managing Secrets - -You can update or manage secrets by clicking the edit button next to the secret that you want to update. This will open a modal where you can update the value of the secret, or delete the secret entirely. - -![Editing Secrets](../../static/img/edit_secrets.png) - -## Further Reading - -- [Managing Secrets with the Devbox CLI](./secrets_cli.md) diff --git a/docs/app/cloud/secrets/index.md b/docs/app/cloud/secrets/index.md deleted file mode 100644 index e9b7f988d3e..00000000000 --- a/docs/app/cloud/secrets/index.md +++ /dev/null @@ -1,24 +0,0 @@ ---- -title: Introduction -sidebar_position: 1 ---- - -Jetify Secrets is a secure secrets management service that lets you store and access secrets for your projects. Secrets are encrypted and stored in the cloud, and are automatically accessed by your project’s Devbox environment whenever you start a shell, run a script, or start a service. - -![Using Devbox Secrets](../../static/img/secrets.gif) - -## Key Concepts - -Jetify provides an easy way to manage secrets for your projects. To get started, it’s helpful to understand the following key concepts: - -**Project** - A Jetify project is a git repo that contains a `devbox.json` file. You can add a project to your Jetify Cloud account by running `devbox secrets init` in the root of your project. Once a project is added to your Jetify Cloud account, you can use Jetify Secrets to manage secrets for that project. - -**Secrets** - Secrets are key-value pairs that are stored securely in the Jetify Secret store. They automatically set as environment variables in your Devbox project whenever you start a shell, run a script, or start a service. Secrets are encrypted at rest and in transit, and are only decrypted when they are accessed by your Devbox environment or by a user in your Jetify Cloud team. - -**Environment** - An environment is a set of secrets that are available to your project. By default, all secrets are set on the `Development` environment, but Devbox also lets you set secrets for a `Preview` and `Production` environment. Starting a shell or running a script in a specific environment gives you access to all the secrets that are set for your environment. - -## Getting Started - -To learn how to set secrets from the Jetify Dashboard, see our [Dashboard Secrets](./dashboard_secrets.md) guide. - -To learn how to use your Secrets with Devbox and manage your secrets from the command line, see our [Secrets CLI Guide](./secrets_cli.md). diff --git a/docs/app/cloud/secrets/secrets_cli.md b/docs/app/cloud/secrets/secrets_cli.md deleted file mode 100644 index 04e62a110da..00000000000 --- a/docs/app/cloud/secrets/secrets_cli.md +++ /dev/null @@ -1,138 +0,0 @@ ---- -title: Managing Secrets with the Devbox CLI -sidebar_position: 3 ---- - -You can access your Jetify Secrets locally using Devbox. When you authenticate your Devbox CLI with Jetify Cloud, Devbox will automatically identify your project, and make your secrets available in your Devbox shell. Developers who are part of your Jetify Cloud team can also access your project’s secrets automatically, whenever they use devbox to start a shell, run a script, or launch a service - -If you don't already have Devbox installed, see our [Quickstart](https://www.jetify.com/docs/devbox/quickstart/) guide to get started. - -## Authenticating with Devbox - -You can authenticate with Jetify Cloud by running `devbox auth login`. This will launch the browser authentication flow to sign into Jetify Cloud. - -![Auth Page](../../static/img/jetify_auth.jpeg) - -Once you complete the authentication flow and select a team, the Devbox CLI will configure itself to use the team you selected - -## Integrating a project with devbox secrets - -To create a new project on Jetify Cloud, navigate to the root directory of your project and run `devbox secrets init` - -```bash -/Users/puckworth/my-project❯ devbox secrets init -? Setup project in /Users/puckworth/my-project? Yes -Initializing project in org -? What’s the name of your new project? my-test-project -Created project my-test-project in org -``` - -Running `devbox secrets init` will create a new project in your current Jetify Cloud account and org, and configure your project to use Jetify Secrets. The project should also be visible if you navigate to the [Jetify Dashboard](../dashboard/index.md). - -## Adding Secrets to your Project - -### Adding Secrets from the Command Line - -You can set secrets using `devbox secrets set`: - -```bash -envsec set FOO=BAR -``` - -```bash -[DONE] Set environment variable 'FOO' in environment: dev -``` - -By default, variables will be set on the `dev` environment. You can set secrets on other environments by passing the `--environment` flag: - -```bash -devbox secrets set FOO=BAR --environment prod -``` - -Supported environments include `dev`, `preview`, and `prod`. - -### Adding Secrets from a File - -You can bulk add secrets from a file by using `devbox secrets import`: - -```bash -devbox secrets import .env.dev -[DONE] Uploaded 3 environment variable(s) from file '.env.dev' to environment: dev -``` - -The file should follow the `.env` format, with each line containing a single environment variable in the form: - -```env -VARIABLE_NAME=VARIABLE_VALUE -``` - -````bash - -## Viewing your Project’s Secrets - -You can view your project’s secrets by running `devbox secrets ls`: - -```bash -Environment: dev -+-----------------+-------+ -| NAME | VALUE | -+-----------------+-------+ -| FOO | ***** | -| DEV_SERVER | ***** | -| PG_PASSWORD | ***** | -+-----------------+-------+ - -Environment: prod -+-----------------+-------+ -| NAME | VALUE | -+-----------------+-------+ -| FOO | ***** | -| PG_PASSWORD | ***** | -+-----------------+-------+ - -Environment: preview -+-----------------+-------+ -| NAME | VALUE | -+-----------------+-------+ -| FOO | ***** | -| PG_PASSWORD | ***** | -+-----------------+-------+ -```` - -## Accessing your Secrets from a Devbox Shell - -Once your project is configured for Jetify Cloud, Devbox will automatically check whether the project exists in your Jetify Cloud account based on: - -1. Your current project’s Git repository -2. The subfolder where your `devbox.json` is located - -If you have a matching project in your Jetify Cloud account, Devbox will automatically set your secrets as environment variables whenever you: - -1. Start a `devbox shell` -2. Start services with `devbox services up` or `devbox services start` -3. Run a script with `devbox run` - -## Removing a Secret from your Project - -You can remove a secret from your project by running `devbox secrets rm`: - -```bash -devbox secrets rm FOO -[DONE] Deleted environment variable 'FOO' in environment: dev -``` - -## Exporting Secrets to a File - -You can export your secrets to a `.env` file using `devbox secrets download`: - -```bash -devbox secrets download .env -[DONE] Downloaded environment variables to '.env' for environment: dev -``` - -You can download from a specific environment using the `--environment` flag: - -## Further Reading - -- [Devbox Secrets CLI Reference](/docs/devbox/cli_reference/devbox_secrets) -- [Managing Secrets from the Dashboard](../dashboard_secrets) diff --git a/docs/app/cloud/sidebar.ts b/docs/app/cloud/sidebar.ts deleted file mode 100644 index 355675e4aeb..00000000000 --- a/docs/app/cloud/sidebar.ts +++ /dev/null @@ -1,59 +0,0 @@ -import type { SidebarsConfig } from "@docusaurus/plugin-content-docs"; - -const cloudSidebar: SidebarsConfig = { - sidebar: [ - { - type: "doc", - id: "index", - }, - { - type: "category", - label: "Secrets", - collapsible: false, - items: [ - { - type: "autogenerated", - dirName: "secrets", - }, - ], - }, - { - type: "category", - label: "Package Cache", - collapsible: false, - items: [ - { - type: "autogenerated", - dirName: "cache", - }, - ], - }, - { - type: "category", - label: "Deploying your Project with Jetify Deployments", - items: [ - { - type: "autogenerated", - dirName: "deploys", - }, - ], - }, - { - type: "category", - label: "Teams and Projects", - collapsible: false, - items: [ - { - type: "autogenerated", - dirName: "dashboard", - }, - ], - }, - { - type: "doc", - id: "faq", - }, - ], -}; - -export default cloudSidebar.sidebar; diff --git a/docs/app/cloud_sidebars.js b/docs/app/cloud_sidebars.js deleted file mode 100644 index dae19824e8e..00000000000 --- a/docs/app/cloud_sidebars.js +++ /dev/null @@ -1,23 +0,0 @@ -/** - * Creating a sidebar enables you to: - - create an ordered group of docs - - render a sidebar for each doc of that group - - provide next/previous navigation - - The sidebars can be generated from the filesystem, or explicitly defined here. - - Create as many sidebars as you want. - */ - -// @ts-check - -/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */ -const sidebars = { - // By default, Docusaurus generates a sidebar from the docs folder structure - // tutorialSidebar: [{ type: 'autogenerated', dirName: '.' }], - - // But you can create a sidebar manually - cloudSidebar: require("./cloud/sidebar"), -}; - -export default sidebars; diff --git a/docs/app/devbox.json b/docs/app/devbox.json deleted file mode 100644 index 6a197486230..00000000000 --- a/docs/app/devbox.json +++ /dev/null @@ -1,18 +0,0 @@ -{ - "packages": [ - "nodejs@20.12.2", - ], - "env": { - "DEVBOX_COREPACK_ENABLED": "true", - }, - "shell": { - "init_hook": [ - "test \"$SKIP_INIT_HOOK\" = \"1\" || pnpm install", - ], - "scripts": { - "build": "pnpm run build", - "start": "pnpm run start", - "serve": "pnpm run serve", - }, - }, -} diff --git a/docs/app/devbox.lock b/docs/app/devbox.lock deleted file mode 100644 index 670f1c2f800..00000000000 --- a/docs/app/devbox.lock +++ /dev/null @@ -1,73 +0,0 @@ -{ - "lockfile_version": "1", - "packages": { - "github:NixOS/nixpkgs/nixpkgs-unstable": { - "resolved": "github:NixOS/nixpkgs/02032da4af073d0f6110540c8677f16d4be0117f?lastModified=1741037377&narHash=sha256-SvtvVKHaUX4Owb%2BPasySwZsoc5VUeTf1px34BByiOxw%3D" - }, - "nodejs@20.12.2": { - "last_modified": "2024-06-12T20:55:33Z", - "plugin_version": "0.0.2", - "resolved": "github:NixOS/nixpkgs/a9858885e197f984d92d7fe64e9fff6b2e488d40#nodejs_20", - "source": "devbox-search", - "version": "20.12.2", - "systems": { - "aarch64-darwin": { - "outputs": [ - { - "name": "out", - "path": "/nix/store/ridvrr7dsnxpvh3f1sr41xiwvwk1nnkg-nodejs-20.12.2", - "default": true - }, - { - "name": "libv8", - "path": "/nix/store/08xq7dq3gmv0cs6b4283xihjvhy9d1vy-nodejs-20.12.2-libv8" - } - ], - "store_path": "/nix/store/ridvrr7dsnxpvh3f1sr41xiwvwk1nnkg-nodejs-20.12.2" - }, - "aarch64-linux": { - "outputs": [ - { - "name": "out", - "path": "/nix/store/ybhzncvkslqd0b9c3lp91l0wphjzczc8-nodejs-20.12.2", - "default": true - }, - { - "name": "libv8", - "path": "/nix/store/5gbmjz6s6bqniqpmzszz1mxis6bsvkk7-nodejs-20.12.2-libv8" - } - ], - "store_path": "/nix/store/ybhzncvkslqd0b9c3lp91l0wphjzczc8-nodejs-20.12.2" - }, - "x86_64-darwin": { - "outputs": [ - { - "name": "out", - "path": "/nix/store/gxi71m2y8x1rl83dpr1g0x9yz3klrcb0-nodejs-20.12.2", - "default": true - }, - { - "name": "libv8", - "path": "/nix/store/mmfi1a89j8ph7x0rkqy43fc9h31hxxcr-nodejs-20.12.2-libv8" - } - ], - "store_path": "/nix/store/gxi71m2y8x1rl83dpr1g0x9yz3klrcb0-nodejs-20.12.2" - }, - "x86_64-linux": { - "outputs": [ - { - "name": "out", - "path": "/nix/store/74a6mmrgxzcg9axl1gmdz3j2y1bjd13f-nodejs-20.12.2", - "default": true - }, - { - "name": "libv8", - "path": "/nix/store/qgrqys125k7c7ish5l1bkphgi49nbcig-nodejs-20.12.2-libv8" - } - ], - "store_path": "/nix/store/74a6mmrgxzcg9axl1gmdz3j2y1bjd13f-nodejs-20.12.2" - } - } - } - } -} diff --git a/docs/app/docs/cli_reference/_category_.json b/docs/app/docs/cli_reference/_category_.json deleted file mode 100644 index 9d96a3afc78..00000000000 --- a/docs/app/docs/cli_reference/_category_.json +++ /dev/null @@ -1,4 +0,0 @@ -{ - "label": "CLI Reference", - "position": 5 -} \ No newline at end of file diff --git a/docs/app/docs/cli_reference/devbox.md b/docs/app/docs/cli_reference/devbox.md deleted file mode 100644 index 4f87ce0b8b6..00000000000 --- a/docs/app/docs/cli_reference/devbox.md +++ /dev/null @@ -1,30 +0,0 @@ -# devbox - -Instant, easy, predictable shells and containers - -```bash -devbox [flags] -``` - -## Options - - -| Option | Description | -| --- | --- | -| `-h, --help` | help for devbox | -| `-q, --quiet` | Quiet mode: Suppresses logs. | - -## SEE ALSO - -* [devbox add](./devbox_add.md) - Add a new package to your devbox -* [devbox generate](devbox_generate.md) - Generate supporting files for your project -* [devbox global](./devbox_global.md) - Manages global Devbox packages -* [devbox info](devbox_info.md) - Display package and plugin info -* [devbox init](./devbox_init.md) - Initialize a directory as a devbox project -* [devbox install](./devbox_install.md) - Install your project's packages -* [devbox rm](./devbox_rm.md) - Remove a package from your devbox -* [devbox run](devbox_run.md) - Starts a new devbox shell and runs the target script -* [devbox services](devbox_services.md) - Interact with Devbox Services -* [devbox shell](./devbox_shell.md) - Start a new shell or run a command with access to your packages -* [devbox version](./devbox_version.md) - Print version information - diff --git a/docs/app/docs/cli_reference/devbox_add.md b/docs/app/docs/cli_reference/devbox_add.md deleted file mode 100644 index 13d8b48c217..00000000000 --- a/docs/app/docs/cli_reference/devbox_add.md +++ /dev/null @@ -1,56 +0,0 @@ -# devbox add - -Add a new package to your devbox - -```bash -devbox add ... [flags] -``` - -## Examples - -```bash -# Add the latest version of the `ripgrep` package -devbox add ripgrep - -# Install glibcLocales only on x86_64-linux and aarch64-linux -devbox add glibcLocales --platform x86_64-linux,aarch64-linux - -# Exclude busybox from installation on macOS -devbox add busybox --exclude-platform aarch64-darwin,x86_64-darwin - -# Install non-default outputs for a package, such as the promtool CLI -devbox add prometheus --outputs=out,cli -``` - -## Options - - -| Option | Description | -| --- | --- | -| `--allow-insecure` | allows Devbox to install a package that is marked insecure by Nix | -| `-c, --config string` | path to directory containing a devbox.json config file | -| `--disable-plugin` | disable the build plugin for a package | -| `--environment string` | Jetify Secrets environment to use, when supported (e.g.secrets support dev, prod, preview.) (default "dev") | -| `-e, --exclude-platform strings` | exclude packages from a specific platform. | -| `-h, --help` | help for add | -| `-o, --outputs strings` | specify the outputs to install for the nix package | -| `-p`, `--platform strings` | install packages only on specific platforms. | -| `--patch` | Allow Devbox to patch your packages to fix issues with missing native libraries (auto, always, never) (default "auto")| -| `-q, --quiet` | quiet mode: Suppresses logs. | - -Valid Platforms include: - -* `aarch64-darwin` -* `aarch64-linux` -* `x86_64-darwin` -* `x86_64-linux` - -The platforms below are also supported, but will build packages from source - -* `i686-linux` -* `armv7l-linux` - - -## SEE ALSO - -* [devbox](./devbox.md) - Instant, easy, predictable shells and containers diff --git a/docs/app/docs/cli_reference/devbox_cache.md b/docs/app/docs/cli_reference/devbox_cache.md deleted file mode 100644 index 1b38aa284a3..00000000000 --- a/docs/app/docs/cli_reference/devbox_cache.md +++ /dev/null @@ -1,17 +0,0 @@ -# devbox cache - -A collection of commands to interact with the Jetify Cache or other Nix caches. - -```bash - devbox cache [command] -``` - -## Subcommands - info Output information about the nix cache - upload upload specified or nix packages in current project to cache - -## Options -| Option | Description | -| --- | --- | -| `-h, --help` | help for cache | -| `-q, --quiet` | suppresses logs | diff --git a/docs/app/docs/cli_reference/devbox_cache_configure.md b/docs/app/docs/cli_reference/devbox_cache_configure.md deleted file mode 100644 index 573a9cdf63d..00000000000 --- a/docs/app/docs/cli_reference/devbox_cache_configure.md +++ /dev/null @@ -1,28 +0,0 @@ -# devbox cache configure - -Configure Nix to use the Devbox cache as a substituter. - -If the current Nix installation is multi-user, this command grants the Nix -daemon access to Devbox caches by making the following changes: - -- Adds the current user to Nix's list of trusted users in the system nix.conf. -- Adds the cache credentials to ~root/.aws/config. - -Configuration requires sudo, but only needs to happen once. The changes persist -across Devbox accounts and organizations. - -This command is a no-op for single-user Nix installs that aren't running the -Nix daemon. - -```bash - devbox cache configure [flags] -``` - -## Options - - -| Option | Description | -| --- | --- | -| `--user string` | The OS user to configure Nix for. Defaults to the current user. | -| `-h, --help` | help for configure | -| `-q, --quiet` | suppresses logs | diff --git a/docs/app/docs/cli_reference/devbox_cache_info.md b/docs/app/docs/cli_reference/devbox_cache_info.md deleted file mode 100644 index a92b0de2f6a..00000000000 --- a/docs/app/docs/cli_reference/devbox_cache_info.md +++ /dev/null @@ -1,14 +0,0 @@ -# devbox cache info - -Output information about the nix cache - -```bash - devbox cache info [flags] -``` - -## Options - -| Option | Description | -| --- | --- | -| `-h, --help` | help for info | -| `-q, --quiet` | suppresses logs | \ No newline at end of file diff --git a/docs/app/docs/cli_reference/devbox_cache_upload.md b/docs/app/docs/cli_reference/devbox_cache_upload.md deleted file mode 100644 index c756c766414..00000000000 --- a/docs/app/docs/cli_reference/devbox_cache_upload.md +++ /dev/null @@ -1,23 +0,0 @@ -# devbox cache upload - -Upload specified nix installable or nix packages in current project to cache. -If [installable] is provided, only that installable will be uploaded. -Otherwise, all packages in the project will be uploaded. -To upload to specific cache, use --to flag. Otherwise, a cache from -the cache provider will be used, if available. - -```bash -devbox cache upload [installable] [flags] -``` - -## Aliases -upload, copy - -## Options - -| Option | Description | -| --- | --- | -| `-c, --config string` | path to directory containing a devbox.json config file | -| `-h, --help` | help for upload | -| `--to string` | URI of the cache to copy to | -| `-q, --quiet` | suppresses logs | \ No newline at end of file diff --git a/docs/app/docs/cli_reference/devbox_completion.md b/docs/app/docs/cli_reference/devbox_completion.md deleted file mode 100644 index 2db611f3c0f..00000000000 --- a/docs/app/docs/cli_reference/devbox_completion.md +++ /dev/null @@ -1,25 +0,0 @@ -# devbox completion - -Generate the autocompletion script for the specified shell - -## Synopsis - -Generate the autocompletion script for devbox for the specified shell. -See each sub-command's help for details on how to use the generated script. - - -## Options - - -| Option | Description | -| --- | --- | -| `-h, --help` | help for completion | -| `-q, --quiet` | suppresses logs | - -## SEE ALSO - -* [devbox](devbox.md) - Instant, easy, predictable development environments -* [devbox completion bash](devbox_completion_bash.md) - Generate the autocompletion script for bash -* [devbox completion fish](devbox_completion_fish.md) - Generate the autocompletion script for fish -* [devbox completion zsh](devbox_completion_zsh.md) - Generate the autocompletion script for zsh - diff --git a/docs/app/docs/cli_reference/devbox_completion_bash.md b/docs/app/docs/cli_reference/devbox_completion_bash.md deleted file mode 100644 index 96bf962d1b6..00000000000 --- a/docs/app/docs/cli_reference/devbox_completion_bash.md +++ /dev/null @@ -1,47 +0,0 @@ -# devbox completion bash - -Generate the autocompletion script for the bash shell. - -This script depends on the 'bash-completion' package. -If it is not installed already, you can install it via your OS's package manager. - -To load completions in your current shell session: - -```bash - source <(devbox completion bash) -``` - -To load completions for every new session, execute once: - -## Linux - -```bash - devbox completion bash > /etc/bash_completion.d/devbox -``` - -## macOS - -```bash - devbox completion bash > $(brew --prefix)/etc/bash_completion.d/devbox -``` - -You will need to start a new shell for this setup to take effect. - - -```bash -devbox completion bash -``` - -## Options - - -| Option | Description | -| --- | --- | -| `-h, --help` | help for bash | -| `--no-descriptions` | disable completion descriptions | -| `-q, --quiet` | suppresses logs | - -## SEE ALSO - -* [devbox completion](devbox_completion.md) - Generate the autocompletion script for the specified shell - diff --git a/docs/app/docs/cli_reference/devbox_completion_fish.md b/docs/app/docs/cli_reference/devbox_completion_fish.md deleted file mode 100644 index 86b087c276e..00000000000 --- a/docs/app/docs/cli_reference/devbox_completion_fish.md +++ /dev/null @@ -1,36 +0,0 @@ -# devbox completion fish - -Generate the autocompletion script for the fish shell. - -To load completions in your current shell session: - -```bash -devbox completion fish | source -``` - -To load completions for every new session, execute once: - -```bash -devbox completion fish > ~/.config/fish/completions/devbox.fish -``` - -You will need to start a new shell for this setup to take effect. - - -```bash -devbox completion fish [flags] -``` - -## Options - - -| Option | Description | -| --- | --- | -| `-h, --help` | help for fish | -| `--no-descriptions` | disable completion descriptions | -| `-q, --quiet` | suppresses logs | - -## SEE ALSO - -* [devbox completion](devbox_completion.md) - Generate the autocompletion script for the specified shell - diff --git a/docs/app/docs/cli_reference/devbox_completion_zsh.md b/docs/app/docs/cli_reference/devbox_completion_zsh.md deleted file mode 100644 index ac37ffb9118..00000000000 --- a/docs/app/docs/cli_reference/devbox_completion_zsh.md +++ /dev/null @@ -1,59 +0,0 @@ -# devbox completion zsh - -Generate the autocompletion script for the zsh shell. - -If you are using Oh My Zsh, just run the following: - -```bash -mkdir -p ~/.oh-my-zsh/completions -devbox completion zsh > ~/.oh-my-zsh/completions/_devbox -``` - -If you are not using Oh My Zsh and shell completion is not already enabled in your environment you will need -to enable it. You can execute the following once: - -```bash -echo "autoload -U compinit; compinit" >> ~/.zshrc -``` - -To load completions in your current shell session: - -```bash -source <(devbox completion zsh); compdef _devbox devbox -``` - -To load completions for every new session, execute once: - -## Linux - -```bash -devbox completion zsh > "${fpath[1]}/_devbox" -``` - -## macOS - -```bash -devbox completion zsh > $(brew --prefix)/share/zsh/site-functions/_devbox -``` - -You will need to start a new shell for this setup to take effect. - - -```text -devbox completion zsh [flags] -``` - -## Options - - -| Option | Description | -| --- | --- | -| `-h, --help` | help for zsh | -| `--no-descriptions` | disable completion descriptions | -| `-q, --quiet` | suppresses logs | - - -## SEE ALSO - -* [devbox completion](devbox_completion.md) - Generate the autocompletion script for the specified shell - diff --git a/docs/app/docs/cli_reference/devbox_create.md b/docs/app/docs/cli_reference/devbox_create.md deleted file mode 100644 index a7c8ce1674d..00000000000 --- a/docs/app/docs/cli_reference/devbox_create.md +++ /dev/null @@ -1,39 +0,0 @@ -# devbox create - -Initialize a directory as a devbox project using a template - -## Synopsis - -Initialize a directory as a devbox project. This will create an empty devbox.json in the current directory. You can then add packages using `devbox add` - -```bash -devbox create [dir] --template