Create @qwikdev/astro 🎉

The Ultimate Starter for QwikDev/Astro Projects

Seamlessly scaffold content-driven web projects with the power of QwikDev/Astro. Whether you're building blazing-fast blogs, portfolios, or scalable applications, this CLI has you covered.

---

🚀 Installation & Usage

🧑‍💻 Usage

Run the following command using your preferred package manager:

• With NPM:

  1npm create @qwikdev/astro@latest [destination] [adapter] [...options]

• With Yarn:

  1yarn create @qwikdev/astro [destination] [adapter] [...options]

• With PNPM:

  1pnpm create @qwikdev/astro [destination] [adapter] [...options]

• With Bun:

  1bun create @qwikdev/astro [destination] [adapter] [...options]

🛠️ Flags

Arguments

Customize the command with the following arguments:

Name	Type	Default value	Description
destination	String	./qwik-astro-app	Directory of the project.
adapter	"deno" or "node" or "none"	none	Server adapter.

Options

Enhance your project setup with these additional flags:

Name	Shortcut	Description
--help	-h	Display all available options.
--template	-t	Use an Astro template.
--add / --no-add	-a / --no-a	Add QwikDev/astro to an existing project.
--force / --no-force	-f / --no-f	Overwrite target directory, if needed.
--copy / --no-copy	-c / --no-c	Copy files without overwriting.
--biome / --no-biome		Use Biome instead of ESLint/Prettier.
--install / --no-install	-i / --no-i	Automatically install dependencies.
--git / --no-git		Initialize a Git repository.
--ci / --no-ci		Add CI workflow.
--yes	-y	Accept all default configurations.
--no	-n	Decline all default configurations.
--dry-run		Simulate the setup process without executing.

💡 Examples

The easiest way to explore QwikDev/Astro on your machine is by running the following command:

1npm create @qwikdev/astro@latest

1. Start Without Any Template

   You can create a project with no template to keep it minimal or customize it from scratch. This approach uses only the default starter kit provided by the integration:

   1npm create @qwikdev/astro@latest my-project

   To skip all prompts and initialize without a template automatically:

   1npm create @qwikdev/astro@latest my-project --yes

2. Add Qwik/Astro to an Existing Project**

   If you already have an existing project and want to integrate QwikDev/Astro without creating a new project, you can use the --add option:

   1npm create @qwikdev/astro@latest my-existing-project --add

3. Use an Official Template

   You can initialize a project with a pre-built template (e.g., minimal, portfolio, starlight, blog, etc.):

   1npm create @qwikdev/astro@latest --template <name>

   The full list of templates is quite long, so make sure to check it out to find one that fits your project needs.

4. Clone a Specific GitHub Repository

   You can use any GitHub repository as a template:

   1npm create @qwikdev/astro@latest --template <user>/<repo>

   For a broader range of community-provided templates, visit the Awesome Astro repository.

5. Use Nested GitHub Examples

   Paths to examples nested inside a GitHub repository are also supported:

   1npm create @qwikdev/astro@latest --template <user>/<repo>/path/to/example

6. Advanced Use Cases

   You can combine multiple flags to set up your project exactly as needed:

   1npm create @qwikdev/astro my-existing-project --add --copy --template portfolio --yes --no-git --no-ci

📦 API

For developers looking to programmatically access the CLI functionality:

1. Basic Usage

   Run the CLI programmatically without arguments:

   1import createQwikAstro from '@qwikdev/create-astro';
   2
   3createQwikAstro();

2. With Custom Arguments

   Specify arguments directly:

   1import { run } from '@qwikdev/create-astro';
   2
   3run(["./qwik-astro-app", "node"]);

3. Definition Types

   Define the structure of the CLI options and arguments:

   1export type Definition = {
   2  destination: string;
   3  adapter?: "deno" | "node" | "none";
   4  template?: string;
   5  add?: boolean;
   6  force?: boolean;
   7  copy?: boolean;
   8  biome?: boolean;
   9  install?: boolean;
   10  git?: boolean;
   11  ci?: boolean;
   12  yes?: boolean;
   13  no?: boolean;
   14  dryRun?: boolean;
   15};

4. Default Settings

   Here are the default configurations:

   1export const defaultDefinition = {
   2  destination: "./qwik-astro-app",
   3  adapter: "none",
   4  template: "",
   5  add: undefined,
   6  force: undefined,
   7  copy: undefined,
   8  biome: undefined,
   9  install: undefined,
   10  git: undefined,
   11  ci: undefined,
   12  yes: undefined,
   13  no: undefined,
   14  dryRun: undefined
   15} as const;

🌐 Community

• 🐦 Ping @QwikDev on Twitter
• 💬 Join our Discord community for discussions and support

🔗 Related Links

• 📖 Qwik – Build instantly-interactive web apps.
• 📖 Astro – The web framework for content-rich websites.
• 🌟 Awesome Astro (Community Examples)
• 📚 Full List of Templates