百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
L

lexicon

> 编程语言
开源

Lexicon 使用 Expo、React Native 和 GraphQL 构建,是一个预先构建的移动讨论应用,您可以为用户进行定制。

200 stars0 点赞2 次浏览
访问官网GitHub

工具介绍

Lexicon 使用 Expo、React Native 和 GraphQL 构建,是一个预先构建的移动讨论应用,您可以为用户进行定制。

Lexicon

Lexicon is a customizable, open source mobile App Template that provides an elegant mobile discussions experience. Built on top of Discourse, a platform for communities.

Benefits

  • Launch a mobile app customized for your Discourse site
  • Increase engagement with your users by adding a mobile experience
  • Built with React Native: designed from the ground up for a mobile first experience - no webviews!

Project Roadmap

Lexicon is currently under active development. You can stay up to date on the features we're working on by viewing the Project Roadmap.

Discussions

For more detailed information, updates, and discussions, please visit the Lexicon Discussions section on GitHub.

Installation

Clone the repository and navigate into it:

bash
git clone [email protected]:lexiconhq/lexicon.git
cd lexicon

Next, execute the following command.

$ yarn && yarn generate

yarn will install the dependencies needed, while yarn generate will launch two processes sequentially.

  • First, it will generate a GraphQL schema in the api directory.

  • Then it will create a new folder called generated in the frontend directory. This contains the GraphQL query and mutation types based on the schema generated above. Click here to learn more about this process.

Quick Start

You can run the Lexicon Mobile App and test it out by running this command from the project root:

$ yarn quickstart

This will simultaneously launch two processes:

  • The Prose GraphQL API Server
  • The local Expo dev server, which will enable you to launch the React Native app from your device

The quickstart commands are designed to point at an existing public Discourse server, Discourse Meta.

Configuring it to point at your own Discourse site will take additional configuration.

We guide you through the basics of this in the next section below.

You can also learn more about this process in detail in the Lexicon Documentation.

Example: Specifying a custom Discourse Site URL

This is a brief example to demonstrate how to quickly point the project at a custom Discourse site.

In the example below, we'll use the Rust Users forum.

You can also follow along using your own site if you'd like.

After running yarn && yarn generate from the project root, execute the following:

$ echo "PROSE_DISCOURSE_HOST=https://users.rust-lang.org" > api/.env

The above command sets the required environment variable for the Prose GraphQL API.

Next, open up frontend/Config.ts, and set the value at config.localDevelopment.proseUrl to http://localhost.

typescript
const config = {
  localDevelopment: {
    proseUrl: 'http://localhost',
  },
  // ...
};

This instructs the frontend to attempt to connect to a Prose GraphQL API running at http://localhost.

To bring it all together:

  • The frontend (via localDevelopment.proseUrl) has been instructed to connect to a Prose GraphQL API running at http://localhost (port 80).

  • The Prose GraphQL API (via PROSE_DISCOURSE_HOST) has been instructed to connect to a Discourse instance at https://users.rust-lang.org.

  • When you launch the Mobile App via Expo Go, it will reach out to the API running at http://localhost, which will contact the Discourse server at https://users.rust-lang.org, and the content of that server will appear in the Mobile App.

Important Notes

The API's default config instructs the server to listen on a hostname of 0.0.0.0 (the public interface) and port 80.

The frontend takes some additional steps so that you can test the app with Expo Go on your mobile device... (Read More)

This may seem confusing at first, but it actually saves you a bit of time.

In this scenario, the frontend app is running on your mobile device via Expo Go, and the Prose GraphQL API is running on your development machine (e.g., your laptop).

So, how could we expect the mobile app to be able to locate a server running on a different device, when we have only told the frontend app to attempt to connect to the API on localhost? The API isn't running on your mobile device.

The traditional way to deal with this is to force you to manually lookup your local IP address on the network that your mobile device is also connected to. It would be a value like 192.168.0.53.

Then, you'd have to update frontend/Config.ts with that value.

Even worse, if your local IP address ever changes, everything would break, and you'd have to update the environment variable again.

That's kind of a pain, and fortunately Expo provides us with an easier way.

We leverage a property from Expo called debuggerHost in order to automatically locate the IP address of your development machine. From that value, we strip off the port number (typically 19000) and append the port number that your Prose GraphQL API is running on (defaults to port 80).

With this approach, it should all just work automatically.

If you're interested, you can read the code for how we achieve this here: src/frontend/constants/app.ts

Start the Prose GraphQL API server

Next, start the Prose GraphQL API server.

$ yarn --cwd api start

You should see output that looks similar to this:

Attempting to reach your Discourse instance at https://users.rust-lang.org...
Your Discourse instance was reachable and valid.

 -- Prose GraphQL Discourse API --
forwarding Discourse requests to https://users.rust-lang.org

    Yoga -   Running GraphQL Server at http://0.0.0.0:8999/graphql

Start Expo Go to run the frontend app

After that, in a separate shell, start Expo to run the frontend app:

$ cd frontend
$ yarn start

You should see the typical Expo output with a QR code that you can scan from your mobile device to open the app, as well as some output similar to this:

Starting project at lexicon/frontend
Starting Metro Bundler
...

› Metro waiting on exp://192.168.0.53:19000
› Scan the QR code above with Expo Go (Android) or the Camera app (iOS)

...

Logs for your project will appear below. Press Ctrl+C to exit.
Started Metro Bundler

Scan the QR code and open the app on your mobile device

Once you've scanned the QR code on your mobile device, you will be instructed to download Expo / Expo Go if you haven't already.

After that, you should be able to open the Lexicon frontend on your mobile device via the QR code, and will be able to interact with the Discourse site you configured Prose to connect to.


Professional Support

With official support, you get expert help straight from the core team. We provide dedicated support, prioritize feature requests, deployment strategies, advice on best practices, design decisions, and team augmentation. Reach out to us for consulting at [email protected].

Documentation

The full documentation for Lexicon is located at docs.lexicon.is.

If you'd like to contribute to it, or just want to browse it locally, you can run the following command from the project root:

bash
yarn docs:install
yarn docs:start

Issues· 12 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

TypeScript

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言