Skip to content

dalmasonto/specra-cli

Repository files navigation

create-specra

The fastest way to create a new Specra documentation site. Scaffold a complete documentation project with a single command.

Usage

With npx (recommended)

npx create-specra my-docs

With npm

npm create specra my-docs

With yarn

yarn create specra my-docs

With pnpm

pnpm create specra my-docs

Options

npx create-specra [project-directory] [options]

Arguments

  • [project-directory] - The directory to create the project in (optional, will prompt if not provided)

Options

  • --template <template> - Template to use: minimal (will prompt if not provided)
  • --use-npm - Use npm as the package manager
  • --use-pnpm - Use pnpm as the package manager
  • --use-yarn - Use yarn as the package manager
  • --skip-install - Skip package installation

Templates

Minimal (Default)

Minimal setup to get started quickly:

  • Basic documentation structure
  • Essential configuration
  • Clean starting point
  • Ready to customize

Examples

Create a new project with interactive prompts:

npx create-specra

Create a project with the minimal template using npm:

npx create-specra my-docs --template minimal --use-npm

Create a project and skip installation:

npx create-specra my-docs --skip-install

What's Created

The CLI creates a new Next.js project with Specra pre-configured:

my-docs/
├── app/
│   ├── layout.tsx
│   ├── page.tsx
│   └── [...slug]/
│       └── page.tsx
├── docs/
│   └── v1.0.0/
│       └── index.mdx
├── public/
├── specra.config.ts
├── next.config.js
├── tailwind.config.ts
└── package.json

After Creation

Once your project is created, you can:

  1. Start the development server:

    cd my-docs
    npm run dev
  2. Open http://localhost:3000 in your browser

  3. Edit your documentation in the docs/ directory

  4. Customize your site in specra.config.ts

What is Specra?

Specra is a modern documentation library for Next.js that provides:

  • Multi-version documentation support
  • API reference generation
  • Full-text search
  • MDX-powered content
  • Beautiful UI components

Learn More

License

MIT

Authors

dalmasonto, arthur-kamau

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published