You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: At its core, LogChimp is powered by RESTful JSON API.
3
+
description: LogChimp's foundation lies in its powerfull RESTful JSON API.
4
4
slug: /docs/architecture/api
5
5
---
6
6
7
-
At its core, LogChimp is a RESTful JSON API - designed to track, manage, engage, and analyze user feedback with ease.
7
+
LogChimp's foundation lies in its RESTful JSON API, designed to effortlessly track, manage, engage, and analyze user feedback.
8
8
9
-
To know more about [LogChimp APIs](/api).
9
+
To learn more about [LogChimp APIs](/api).
10
10
11
11
### Versioning
12
12
13
-
Each major version of LogChimp ships with multiple versions of the APIs. We maintain a stable APIs so that you can be sure about depending on them in production.
13
+
Each major version of LogChimp ships with multiple versions of the APIs. We maintain stable APIs so that you can confidently depend on them in production.
LogChimp is an independent, built on a modern technology stack of Node.js for powering its robust JSON API, stand-alone system with dependency only on the database (PostgreSQL) as a data storage layer, with a beautiful and rich client app written in Vue.js including a powerful dashboard - find out more.
7
+
LogChimp is an independent system built on a modern technology stack. It utilizes Node.js to power its robust JSON API and relies solely on the PostgreSQL database as its data storage layer. Complemented by a beautifully crafted client app written in Vue.js with Typescript, LogChimp offers a powerful dashboard, providing users with a comprehensive experience.
8
8
9
-
A high-level view of LogChimp's architecture is as shown:
9
+
A high-level overview of LogChimp's architecture is shown below:
These five areas work together to make every LogChimp site function smoothly.
13
+
These five components work together seamlessly to ensure the smooth functioning of every LogChimp site:
14
14
15
15
1.[Robust REST APIs](/docs/architecture/api)
16
16
2. Beautiful Vue.js client app
17
17
3. Powerful Dashboard
18
18
4. PostgreSQL Database
19
19
5. Disk storage space
20
20
21
-
## Node environment
21
+
## Node Environment
22
22
23
-
LogChimp supports three environments: `development`, `testing`, `production`. A public LogChimp site should always run in **production** mode, development is used for building LogChimp locally and testing is only used in CI/CD to run tests.
23
+
LogChimp supports three environments: `development`, `testing`, and `production`.
24
+
25
+
Public LogChimp sites should always run in **production** mode, while the `development` environment is used for the local development of LogChimp. The `testing` environment is exclusively employed in CI/CD pipelines for running tests.
Copy file name to clipboardExpand all lines: docs/cli/commands.md
+3-3Lines changed: 3 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -1,20 +1,20 @@
1
1
---
2
2
title: Commands
3
-
description: Below are the available LogChimp CLI commands. You can always run `logchimp --help` or `logchimp help [COMMAND]` to get more detail.
3
+
description: Explore the available LogChimp CLI commands below. For detailed information on each command, you can always run `logchimp --help` or `logchimp help [COMMAND]`.
4
4
slug: /docs/cli/commands
5
5
---
6
6
7
7
import { Alert } from "../../../src/components/Documentation/Alert.tsx"
8
8
9
9
<Alerttype="tip">
10
-
Each command is documented in detail on its own page.
10
+
Each command is thoroughly documented on its own page.
Copy file name to clipboardExpand all lines: docs/cli/readme.md
+3-3Lines changed: 3 additions & 3 deletions
Original file line number
Diff line number
Diff line change
@@ -1,16 +1,16 @@
1
1
---
2
2
title: CLI
3
-
description: An all-in-one tool to help you configure and making it super easy to spin up a new LogChimp site.
3
+
description: An all-in-one tool to help you configure and make it super easy to spin up a new LogChimp site.
4
4
slug: /docs/cli
5
5
---
6
6
7
-
We understand that some users are going to want more flexibility, so the CLI has a whole set of flags and options that allow you to break the steps down and adjust what they do.
7
+
We understand that some users are going to want more flexibility, so the CLI has a whole set of flags and options that allow you to break down the steps and adjust what they do.
8
8
9
9
If you have any suggestions or find bugs 🐞, head over to the [LogChimp CLI GitHub repository](https://github.com/logchimp/logchimp-cli) and let us know.
10
10
11
11
## Install
12
12
13
-
LogChimp CLI is an npm package that can be installed via either npm or yarn.
13
+
LogChimp CLI is an npm package that can be installed via either npm or yarn or pnpm.
description: Step by step guide for you to configure LogChimp site using `logchimp.config.json` file.
3
+
description: Step-by-step guide for configuring LogChimp site using `logchimp.config.json` file.
4
4
slug: /docs/config
5
5
---
6
6
7
7
import { Alert } from "../../src/components/Documentation/Alert.tsx"
8
8
9
9
## Overview
10
10
11
-
There are some configuration options which is pre-filled by default at installation process via [one-click deploy](/docs/install) button, and other options needs to be configured manually, _for example secret credentials_.
11
+
Some configuration options are pre-filled by default during the installation process via the [one-click deploy](/docs/install) button, while others need to be configured manually, such as secret credentials.
12
12
13
13
There are two ways to configure your LogChimp site:
14
14
15
-
1.`logchimp.config.json` file
16
-
2.Environment variables
15
+
1.Using the `logchimp.config.json` file
16
+
2.Using environment variables
17
17
18
18
<Alerttype="tip">
19
-
Configuring your LogChimp site is one time task and is not required for you to update often, unless you're rotating your secret credentials.
19
+
Configuring your LogChimp site is a one-time task and is not required to be updated frequently, unless you're rotating your secret credentials.
20
20
</Alert>
21
21
22
22
## `logchimp.config.json` file
23
23
24
24
A custom configuration file must be a valid JSON file located in the root folder.
25
25
26
26
<Alerttype="warning">
27
-
The configuration below is just an example and not recommended for production use.
27
+
The configuration below is just an example and is not recommended for production use.
28
28
</Alert>
29
29
30
-
The two required options are `database` and `server` which are configurated during installation process.
30
+
The two required options are `database` and `server`, which are configured during the installation process.
31
31
32
32
```json lines
33
33
{
@@ -49,7 +49,7 @@ The two required options are `database` and `server` which are configurated duri
49
49
50
50
### Mail
51
51
52
-
LogChimp uses SMPT connection for sending emails programmatically.
52
+
LogChimp uses SMTP connection for sending emails programmatically.
-`LOGCHIMP_SECRET_KEY`: Railway provides an easy way to generate 32-char secret key, by pressing `Command + K` (on MacOS) or `Ctrl + K` (on windows). Of course, you can provide your own secret key as well.
71
+
-`LOGCHIMP_SECRET_KEY`: Railway provides an easy way to generate a 32-character secret key by pressing `Command + K` (on MacOS) or `Ctrl + K` (on Windows). Of course, you can provide your own secret key as well.
72
72
-`PORT`: Please do not change the pre-filled value.
73
-
-`LOGCHIMP`: This tells LogChimp to use environment variables instead of [configuration file](/docs/config). Please do not change the pre-filled value.
74
-
-`LOGCHIMP_THEME_STANDALONE`: LogChimp allows you to run on single port or split API and theme. If you're using Railway deploy button, you can leave the value to`false`.
73
+
-`LOGCHIMP`: This tells LogChimp to use environment variables instead of a [configuration file](/docs/config). Please do not change the pre-filled value.
74
+
-`LOGCHIMP_THEME_STANDALONE`: LogChimp allows you to run on a single port or split API and theme. If you're using the Railway deploy button, you can leave the value as`false`.
75
75
76
76
**DATABASE**
77
77
78
-
You can use your own PostgreSQL database or use PostgreSQL plugin provided by Railway. If you're using Railway plugin, you don't have to change the pre-filled values.
78
+
You can use your own PostgreSQL database or use the PostgreSQL plugin provided by Railway. If you're using the Railway database, you don't have to change the pre-filled values.
79
79
80
-
-`LOGCHIMP_DB_HOST`: Database host; default to `${{ PGHOST }}`
81
-
-`LOGCHIMP_DB_DATABASE`: Database name; default to `${{ PGDATABASE }}`
82
-
-`LOGCHIMP_DB_PORT`: Database port; default to `${{ PGPORT }}`
83
-
-`LOGCHIMP_DB_USER`: Database user; default to `${{ PGUSER }}`
84
-
-`LOGCHIMP_DB_PASSWORD`: Database password; default to `${{ PGPASSWORD }}`
85
-
-`LOGCHIMP_DB_SSL`: Database SSL; default to `true`
80
+
-`LOGCHIMP_DB_HOST`: Database host; defaults to `${{ PGHOST }}`
81
+
-`LOGCHIMP_DB_DATABASE`: Database name; defaults to `${{ PGDATABASE }}`
82
+
-`LOGCHIMP_DB_PORT`: Database port; defaults to `${{ PGPORT }}`
83
+
-`LOGCHIMP_DB_USER`: Database user; defaults to `${{ PGUSER }}`
84
+
-`LOGCHIMP_DB_PASSWORD`: Database password; defaults to `${{ PGPASSWORD }}`
85
+
-`LOGCHIMP_DB_SSL`: Database SSL; defaults to `true`
86
86
87
87
**MAIL**
88
88
89
-
You've have to provide SMPT mail authentication details.
89
+
You have to provide SMTP mail authentication details.
90
90
91
91
-`LOGCHIMP_MAIL_SERVICE`: Name of the email service provider
92
92
-`LOGCHIMP_MAIL_HOST`, `LOGCHIMP_MAIL_USER`, and `LOGCHIMP_MAIL_PASSWORD`
93
-
-`LOGCHIMP_MAIL_PORT`: SMPT port provided by the service provider; default to `587`
93
+
-`LOGCHIMP_MAIL_PORT`: SMTP port provided by the service provider; defaults to `587`
94
94
95
-
**Does LogChimp support SMPT connection URL?**
95
+
**Does LogChimp support SMTP connection URL?**
96
96
97
97
No, currently it's not supported. But you're most welcome to [submit a feature request](https://github.com/logchimp/logchimp) anytime.
0 commit comments