diff --git a/docs.json b/docs.json new file mode 100644 index 0000000..827a132 --- /dev/null +++ b/docs.json @@ -0,0 +1,29 @@ +{ + "name": "SherpaJS", + "description": "Module and Reusable Microservice Platform. Build and modularize custom API endpoints, inspired by NextJS APIs. Export to Vercel and ExpressJS.", + "sidebar": [[ + "Getting Started", + [ + ["Overview - WIP", "/"], + ["Installation - WIP", "/installation"], + ["Project Structure - WIP", "/structure"] + ] + ], [ + "Building Your Application", + [ + ["Defining Routes - WIP", "/"], + ["Dynamic Routes - WIP", "/"], + ["Endpoints - WIP", "/"], + ["Static Assets - WIP", "/"] + ] + ], [ + "API Reference", + [ + ["Response - WIP", "/api/response"], + ["Request - WIP", "/api/request"], + ["Headers - WIP", "/api/headers"], + ["Parameters - WIP", "/api/parameters"], + ["SherpaJS CLI", "/api/cli"] + ] + ]] +} \ No newline at end of file diff --git a/docs/api/cli.mdx b/docs/api/cli.mdx new file mode 100644 index 0000000..bbfc427 --- /dev/null +++ b/docs/api/cli.mdx @@ -0,0 +1,98 @@ +--- +title: SherpaJS CLI +description: The SherpaJS CLI allows you to develop, build, start your application, and more. +--- + +# SherpaJS CLI + +The SherpaJS command-line interface (CLI) allows you to develop, build, start your application, and +more. + + +
+ + +## Installation +To install the SherpaJS CLI, simply run the following command: + +```bash +npm install sherpa-core -g +``` + +This command will globally install the SherpaJS core package, enabling you to +utilize its features across your system. Once installed, you can easily run +the SherpaJS command-line interface (CLI) using the following command: + +```bash +sherpa +``` + + +
+ + +## Commands +CLI for SherpaJS - Modular Microservices Framework + +```bash +sherpa [options] [command] +``` + +#### Options: + - `-V`, `--version` output the version number + - `-h`, `--help` display help for command + +#### Commands: + - `build [options]` Build SherpaJS Server + - `start [options]` Start SherpaJS Server Locally + - `clean [options]` Remove SherpaJS Build Directories + - `help [command]` display help for command + + +
+ + +### Build Command +Build SherpaJS Server. +```bash +sherpa build [options] +``` + +#### Options: + - `-i`, `--input ` path to SherpaJS server, defaults to current directory + - `-o`, `--output ` path to server output, defaults to input directory + - `-b`, `--bundler ` platform bundler ("**Vercel**", "*local**", *default: "local"*) + - `-v`, `--variable [key values...]` Specify optional environment variables as key=value pairs Ex. `foo=bar test="1234 HI"` + - `--dev` enable development mode, does not minify output + - `-h`, `--help` display help for command + + + +
+ + +### Start Command +Start SherpaJS Server Locally. Ensure you have created a [local build](/api/cli#build-command). +```bash +sherpa start [options] +``` + +#### Options: + - `-i`, `--input ` path to SherpaJS server, defaults to current directory + - `-p`, `--port ` port number (default: "3000") + - `-h`, `--help` display help for command + + +
+ + +### Clean Command +Remove SherpaJS Build Directories. +```bash +sherpa clean [options] +``` + +#### Options: + - `-i`, `--input ` path to SherpaJS build directories, defaults to current directory + - `-h`, `--help` display help for command + diff --git a/docs/index.mdx b/docs/index.mdx new file mode 100644 index 0000000..0d1828a --- /dev/null +++ b/docs/index.mdx @@ -0,0 +1,7 @@ +--- +title: Overview +description: Instant Open Source docs with zero configuration. +--- + +# SherpaJS - Serverless Web Framework +This site is under development. \ No newline at end of file