create-keystone-app
is a CLI app that makes it easier for you to initiate a Keystone project. It generates some files for you and installs all the dependencies you need to run the Admin UI and start using the GraphQL API.
Installing a Keystone instancenpm create keystone-app@latest
cd my-app
npm run dev
Open your preferred shell and make sure you’re in the folder you want to create your new project in. create-keystone-app
will generate a new folder with your new Keystone files in it.
npxnpm create keystone-app@latest
Use npm's npx
:
Naming your appnpx create-keystone-app@latest
The CLI will ask you to name your app. Once named, it will create a new SQLite database.
You can switch to another database such as PostgreSQL once your project is created, check out the docs on Database Setup.
Opening your shiny new Admin UIYou can now cd
into the folder that was created for you and start Keystone:
This will generate the Admin UI pages via Next.js on http://localhost:3000. When you visit the Admin UI for the first time you will be presented with a handy screen that asks you to create a user:
Go ahead and create your first user. The email address and password will be used to login to Keystone’s Admin UI. Once you've created your user, you’ll be logged in to a new Keystone Admin UI that comes with two lists. From here you can explore and interact with the data in your system, and understand how Keystone’s schema relates to your GraphQL API which you can explore at http://localhost:3000/api/graphql.
OutputKeytone creates the following files in your newly generated folder. The most important ones are keystone.ts
and schema.ts
.
Scripts.
├── auth.ts # Authentication configuration for Keystone
├── keystone.ts # The main entry file for configuring Keystone
├── node_modules # Your dependencies
├── package.json # Your package.json with four scripts prepared for you
├── package-lock.json # Your npm lock file
├── README.md # Additional info to help you get started
├── schema.graphql # GraphQL schema (automatically generated by Keystone)
├── schema.prisma # Prisma configuration (automatically generated by Keystone)
├── schema.ts # Where you design your data schema
└── tsconfig.json # Your typescript config
package.json
includes the following npm scripts you can run locally:
dev
runs Keystone in development mode at http://localhost:3000.start
runs Keystone in production mode.build
will build the project and is required to be run before start
.postinstall
ensures files that Keystone generates exist and are kept up to date.Read more about the CLI in our command line guides.
Where to next?RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4