mirror of https://github.com/codex-team/codex.docs.git synced 2025-07-19 05:09:41 +02:00

Nikita Melnikov 331d45bf73

First run improvements (improved DX and docs) (#169 )

* add some improvements for project start up

* update development docs

* add note about npx

* fix build command in Dockerfile.prod

* doc update

2022-04-12 11:29:25 +04:00

2.7 KiB

Raw Blame History

CodeX Docs

CodeX Docs is a simple but powerful documentation engine for CodeX powered with Editor.js.

You can use CodeX Docs for product documentation, for internal team docs, or for any other documentation.

Development

Prerequisites

NodeJS (v16.x)
npx (installed by default with npm)
Yarn

Install npm packages

yarn install --frozen-lockfile

Create config file

cp .codexdocsrc.sample .codexdocsrc

Run application (both frontend and backend)

yarn dev

Then you can open browser and navigate to http://localhost:3000.

Now you can authenticate in the application and start creating your documentation.

Available scripts

Start whole application (backend and frontend in watch mode)

yarn dev

Start backend in development mode

yarn start-backend

Compile TypeScript files

yarn compile

Build frontend

To build frontend sources run the following command:

yarn build-frontend

To build frontend and watch for changes run the following command:

yarn build-frontend:dev

Run ESLint with `--fix` option

yarn lint

Run tests

yarn test

Authentication

To manage pages you need to authorize (available on /auth).

To set password use yarn generatePassword:ts [password] command and restart the server.

Release process

We use release-drafter to generate release notes and GitHub release. It will automatically generate draft release based pull requests data between current version and previous version. To make new release you need go to releases page find the latest draft release and mark it as ready. After creating new release, new git tag will be created and new version will be published.

About CodeX

CodeX is a team of digital specialists around the world interested in building high-quality open source products on a global market. We are open for young people who want to constantly improve their skills and grow professionally with experiments in cutting-edge technologies.

🌐	Join 👋	Twitter	Instagram
codex.so	codex.so/join	@codex_team	@codex_team

2.7 KiB Raw Blame History