Skip to content

Commit ca31ed1

Browse files
committed
Update docs
1 parent f8742b2 commit ca31ed1

File tree

10 files changed

+34
-81
lines changed

10 files changed

+34
-81
lines changed

packages/create-next-stack/README.md

Lines changed: 28 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -1,50 +1,36 @@
1-
<img width="100%" src="assets/banner.png" alt="A screenshot of the Create Next Stack website">
1+
# Create Next Stack
22

3-
<p align="center">
4-
<a aria-label="NPM version" href="https://www.npmjs.com/package/create-next-stack">
5-
<img alt="" src="https://img.shields.io/npm/v/create-next-stack?style=flat-square">
6-
</a>
7-
<a aria-label="Build status" href="https://github.com/akd-io/create-next-stack/actions/workflows/main.yml?query=branch%3Adevelop">
8-
<img alt="" src="https://img.shields.io/github/actions/workflow/status/akd-io/create-next-stack/main.yml?branch=develop&style=flat-square">
9-
</a>
3+
<p>
104
<a aria-label="Last commit" href="https://github.com/akd-io/create-next-stack/commits/develop">
115
<img alt="" src="https://img.shields.io/github/last-commit/akd-io/create-next-stack/develop?style=flat-square">
126
</a>
13-
<a aria-label="License" href="https://github.com/akd-io/create-next-stack/blob/develop/LICENSE">
7+
<a aria-label="License" href="https://github.com/akd-io/create-next-stack/blob/develop/packages/create-next-stack/LICENSE">
148
<img alt="" src="https://img.shields.io/npm/l/create-next-stack?color=44cc11&style=flat-square">
159
</a>
16-
<a aria-label="Create Next Stack Website GitHub Repository" href="https://github.com/akd-io/create-next-stack-website">
17-
<img alt="" src="https://img.shields.io/badge/Website-gray?style=flat-square&logo=github">
18-
</a>
19-
<a aria-label="GitHub Repo stars" href="https://github.com/akd-io/create-next-stack">
20-
<img alt="" src="https://img.shields.io/github/stars/akd-io/create-next-stack?style=social">
10+
<a aria-label="NPM version" href="https://www.npmjs.com/package/create-next-stack">
11+
<img alt="" src="https://img.shields.io/npm/v/create-next-stack?style=flat-square">
2112
</a>
2213
<a aria-label="Community Discord" href="https://discord.gg/7Ns5WwGjjZ">
2314
<img alt="" src="https://img.shields.io/badge/Discord-gray?style=flat-square&logo=discord">
2415
</a>
2516
<a aria-label="Twitter profile of the creator of Create Next Stack" href="https://twitter.com/akd_io">
2617
<img alt="" src="https://img.shields.io/badge/Twitter-gray?style=flat-square&logo=twitter">
2718
</a>
19+
<a aria-label="GitHub Repo stars" href="https://github.com/akd-io/create-next-stack">
20+
<img alt="" src="https://img.shields.io/github/stars/akd-io/create-next-stack?style=social">
21+
</a>
2822
</p>
2923

3024
[Create Next Stack](https://www.create-next-stack.com/) is a website and CLI tool used to easily set up the boilerplate of new [Next.js](https://github.com/vercel/next.js) apps.
3125

3226
Where [Create Next App](https://github.com/vercel/next.js/tree/canary/packages/create-next-app) lets you choose a single template only, Create Next Stack lets you pick and choose an array of technologies often used alongside Next.js, and free you of the pain of making them work together.
3327

34-
This repository covers the CLI tool, while [create-next-stack-website](https://github.com/akd-io/create-next-stack-website) covers the site.
35-
36-
To get started, go to [create-next-stack.com](https://www.create-next-stack.com). Here you'll be able to choose the technologies you want to use and get the corresponding CLI command.
37-
38-
<p align="center">
39-
<img width="600" alt="Screenshot of Create Next Stack running in a terminal" src="assets/screenshot.png">
40-
</p>
28+
To get started, go to [create-next-stack.com](https://www.create-next-stack.com).
4129

4230
## Supported technologies
4331

4432
The table below provides an overview of the technologies currently supported by Create Next Stack.
4533

46-
### Technologies table
47-
4834
| Name | Links |
4935
| --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
5036
| [Next.js](https://nextjs.org/) (Mandatory) | [Docs](https://nextjs.org/docs) - [Learn Next.js](https://nextjs.org/learn) - [GitHub repo](https://github.com/vercel/next.js) |
@@ -76,26 +62,27 @@ Below you see an overview of Create Next Stack's usage, including detailed infor
7662

7763
```
7864
USAGE
79-
$ create-next-stack [APPNAME]
65+
$ create-next-stack [APP_NAME] [FLAGS]
8066
8167
ARGUMENTS
82-
APPNAME The name of your app, optionally including a path prefix. Eg.: "my-app" or "path/to/my-app"
83-
84-
OPTIONS
85-
-h, --help Shows the CLI help information.
86-
-v, --version Shows the CLI version information.
87-
--chakra Adds Chakra UI. (Component library) (Requires Emotion and Framer Motion)
88-
--debug Show verbose error messages for debugging purposes.
89-
--formatting-pre-commit-hook Adds a formatting pre-commit hook. (Requires Prettier)
90-
--formik Adds Formik. (Form library)
91-
--framer-motion Adds Framer Motion. (Animation library)
92-
--github-actions Adds a GitHub Actions continuous integration workflow.
93-
--material-ui Adds Material UI. (Component library)
94-
--package-manager=(pnpm|yarn|npm) Sets the preferred package manager. (Required)
95-
--prettier Adds Prettier. (Code formatting)
96-
--react-hook-form Adds React Hook Form. (Form library)
97-
--react-icons Adds React Icons. (Icon library)
98-
--styling=<styling-method> Sets the preferred styling method. (Required) <styling-method> = emotion|styled-components|tailwind-css|css-modules|css-modules-with-sass
68+
APP_NAME The name of your app, optionally including a path prefix. Eg.: "my-app" or "path/to/my-app"
69+
70+
FLAGS
71+
-h, --help Shows the CLI help information.
72+
-v, --version Shows the CLI version information.
73+
--chakra Adds Chakra UI. (Component library) (Requires Emotion and Framer Motion)
74+
--debug Show verbose error messages for debugging purposes.
75+
--formatting-pre-commit-hook Adds a formatting pre-commit hook. (Requires Prettier)
76+
--formik Adds Formik. (Form library)
77+
--framer-motion Adds Framer Motion. (Animation library)
78+
--github-actions Adds a GitHub Actions continuous integration workflow.
79+
--material-ui Adds Material UI. (Component library)
80+
--package-manager=<option> Sets the preferred package manager. (Required)
81+
<options: pnpm|yarn|npm>
82+
--prettier Adds Prettier. (Code formatting)
83+
--react-hook-form Adds React Hook Form. (Form library)
84+
--react-icons Adds React Icons. (Icon library)
85+
--styling=<styling-method> Sets the preferred styling method. (Required) <styling-method> = emotion|styled-components|tailwind-css|css-modules|css-modules-with-sass
9986
```
10087

10188
## Contributing
-98.8 KB
Binary file not shown.
-3.36 KB
Binary file not shown.
-2.81 KB
Binary file not shown.
-251 KB
Binary file not shown.

packages/create-next-stack/package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -58,7 +58,7 @@
5858
"test:cna": "pnpm build && ts-node src/tests/e2e/test-live-cna.ts",
5959
"test:cns": "pnpm build && ts-node src/tests/e2e/test-live-cns.ts",
6060
"print:help": "pnpm build && ./bin/dev --help",
61-
"print:version": "pnpm build && ./bin/dev --help",
61+
"print:version": "pnpm build && ./bin/dev --version",
6262
"lint": "eslint --ext=.ts --config=.eslintrc --ignore-path=../../.prettierignore ."
6363
},
6464
"dependencies": {

packages/create-next-stack/src/main/commands/create-next-stack.ts

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -15,13 +15,10 @@ import { logInfo } from "../logging"
1515
import { performSetupSteps } from "../setup/setup"
1616

1717
export default class CreateNextStack extends Command {
18-
static description =
19-
"Create Next Stack is a website and CLI tool used to easily set up the boilerplate of new Next.js apps."
20-
2118
static usage = "[APP_NAME] [FLAGS]" // Without "create-next-stack" as OCLIF adds this, even though this is a single command CLI.
2219

2320
static args = {
24-
appName: Args.string({
21+
app_name: Args.string({
2522
description: `The name of your app, optionally including a path prefix. Eg.: "my-app" or "path/to/my-app"`,
2623
required: false,
2724
}),

website/LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
MIT License
22

3-
Copyright (c) 2021 Anders Kjær Damgaard
3+
Copyright (c) Anders Kjær Damgaard
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

website/README.md

Lines changed: 3 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,43 +1,12 @@
1-
<img width="100%" src="assets/banner.png" alt="A screenshot of the Create Next Stack website">
2-
3-
<p align="center">
4-
<a aria-label="Build status" href="https://github.com/akd-io/create-next-stack-website/actions/workflows/main.yml?query=branch%3Adevelop">
5-
<img alt="" src="https://img.shields.io/github/workflow/status/akd-io/create-next-stack-website/CI/develop?style=flat-square">
6-
</a>
7-
<a aria-label="Last commit" href="https://github.com/akd-io/create-next-stack-website/commits/develop">
8-
<img alt="" src="https://img.shields.io/github/last-commit/akd-io/create-next-stack-website/develop?style=flat-square">
9-
</a>
10-
<a aria-label="License" href="https://github.com/akd-io/create-next-stack-website/blob/develop/LICENSE">
11-
<img alt="" src="https://img.shields.io/npm/l/create-next-stack-website?color=44cc11&style=flat-square">
12-
</a>
13-
<a aria-label="Create Next Stack CLI GitHub Repository" href="https://github.com/akd-io/create-next-stack">
14-
<img alt="" src="https://img.shields.io/badge/CLI-gray?style=flat-square&logo=github">
15-
</a>
16-
<a aria-label="Community Discord" href="https://discord.gg/7Ns5WwGjjZ">
17-
<img alt="" src="https://img.shields.io/badge/Discord-gray?style=flat-square&logo=discord">
18-
</a>
19-
<a aria-label="Twitter profile of the creator of Create Next Stack" href="https://twitter.com/akd_io">
20-
<img alt="" src="https://img.shields.io/badge/Twitter-gray?style=flat-square&logo=twitter">
21-
</a>
22-
</p>
23-
241
# Create Next Stack Website
252

26-
Welcome to the repository of the [create-next-stack.com](https://www.create-next-stack.com/) website.
3+
Welcome to the `create-next-stack-website` package. This package contains the code for [www.create-next-stack.com](https://www.create-next-stack.com/). If you are looking for the CLI, you can find it in the [here](/packages/create-next-stack/README.md).
274

28-
This project acts as the UI for the create-next-stack CLI. All issues not specific to the website should be posted to the [create-next-stack repository](https://github.com/akd-io/create-next-stack) instead.
5+
This website acts as the landing page, UI, and docs, for Create Next Stack.
296

307
## Contributing
318

32-
If you've found a bug or has an idea for an improvement, please [create a new issue](https://github.com/akd-io/create-next-stack-website/issues/new) or fork the project and submit a pull request.
33-
34-
### Getting started
35-
36-
To get started, run:
37-
38-
```bash
39-
yarn dev
40-
```
9+
If you've found a bug or has an idea for an improvement, please [open an issue](https://github.com/akd-io/create-next-stack-website/issues/new) or consider [contributing](../CONTRIBUTING.md).
4110

4211
## Scripts
4312

website/assets/banner.png

-98.8 KB
Binary file not shown.

0 commit comments

Comments
 (0)