Skip to content

Commit 6e57e70

Browse files
committed
start work for launch
1 parent 19c34d7 commit 6e57e70

File tree

4 files changed

+97
-59
lines changed

4 files changed

+97
-59
lines changed

docs/intro.md

+57-20
Original file line numberDiff line numberDiff line change
@@ -4,44 +4,81 @@ sidebar_position: 1
44

55
# Tutorial Intro
66

7-
Let's discover **Docusaurus in less than 10 minutes**.
7+
Let's discover **Outserv in less than 5 minutes.**
88

9-
## Getting Started
9+
## 0. Prerequisites
1010

11-
Get started by **creating a new site**.
11+
:::tip Test Setup (July 2022)
1212

13-
Or **try Docusaurus immediately** with **[docusaurus.new](https://docusaurus.new)**.
13+
- Go version 1.17.6
14+
- Node 16.14.2
15+
- Ubuntu 22.04 LTS
1416

15-
### What you'll need
17+
:::
1618

17-
- [Node.js](https://nodejs.org/en/download/) version 14 or above:
18-
- When installing Node.js, you are recommended to check all checkboxes related to dependencies.
19+
We recommend you use a Linux system to run Outserv. To run lambda functions, we
20+
recommend installing nodejs as well.
1921

20-
## Generate a new site
22+
```bash
23+
sudo apt-get install nodejs
24+
```
25+
26+
## Option 1.a) Download executable
27+
28+
Download the Outserv binary from
29+
[releases](https://github.com/outcaste-io/outserv/releases) and place it in
30+
`/usr/bin` or `/usr/local/bin`.
31+
32+
## Option 1.b) Build Outserv Yourself
33+
34+
```bash
35+
sudo apt-get update
36+
sudo apt-get install gcc make golang
2137

22-
Generate a new Docusaurus site using the **classic template**.
38+
git clone https://github.com/outcaste-io/outserv.git
39+
cd ./outserv
40+
git checkout v22.07.0
41+
make install
42+
```
43+
44+
## 2. Run Outserv GraphQL
2345

24-
The classic template will automatically be added to your project after you run the command:
46+
We will run Outserv with Lambdas. So, ensure that you have NodeJS installed.
2547

2648
```bash
27-
npm init docusaurus@latest my-website classic
49+
outserv graphql --lambda="num=2;" # Data would go into "data" dir.
2850
```
2951

30-
You can type this command into Command Prompt, Powershell, Terminal, or any other integrated terminal of your code editor.
52+
## 3. Load up GraphQL Schema and Lambdas
3153

32-
The command also installs all necessary dependencies you need to run Docusaurus.
54+
You can pick up a GraphQL schema and Lambda code from
55+
[`importers/eth`](https://github.com/outcaste-io/outserv/blob/main/importers/eth),
56+
or use your own schema.
3357

34-
## Start your site
58+
```bash
59+
curl -X POST http://localhost:8080/admin/schema --data-binary '@schema.graphql'
60+
curl -X POST http://localhost:8080/admin/lambda --data-binary '@lambda.js'
61+
```
3562

36-
Run the development server:
63+
## 4. Run Ethereum loader
64+
65+
You can either run geth locally, or you can use a geth gateway provided by
66+
Cloudflare, Alchemy, Infura or others. I recommend using GraphQL endpoint
67+
because that's [much
68+
faster](https://twitter.com/manishrjain/status/1546675483986710529) than
69+
JSON-RPC.
3770

3871
```bash
39-
cd my-website
40-
npm run start
72+
cd importers/eth
73+
go build . && ./eth --geth "GraphQL or JSON-RPC endpoint of Geth"
4174
```
4275

43-
The `cd` command changes the directory you're working with. In order to work with your newly created Docusaurus site, you'll need to navigate the terminal there.
76+
This would start loading ETH transactions into Outserv.
77+
78+
79+
## 5. You're ready
4480

45-
The `npm run start` command builds your website locally and serves it through a development server, ready for you to view at http://localhost:3000/.
81+
You can now use any GraphQL editor (like Insomnia) to query Outserv at:
82+
`http://localhost:8080/graphql`. The editor would show the API documentation
83+
automatically.
4684

47-
Open `docs/intro.md` (this page) and edit some lines: the site **reloads automatically** and displays your changes.

docusaurus.config.js

+29-29
Original file line numberDiff line numberDiff line change
@@ -6,15 +6,15 @@ const darkCodeTheme = require('prism-react-renderer/themes/dracula');
66

77
/** @type {import('@docusaurus/types').Config} */
88
const config = {
9-
title: 'My Site',
10-
tagline: 'Dinosaurs are cool',
11-
url: 'https://your-docusaurus-test-site.com',
9+
title: 'Outserv',
10+
tagline: 'Setup GraphQL Search APIs over Blockchain data 10x faster',
11+
url: 'https://github.com/outcaste-io/outserv',
1212
baseUrl: '/',
1313
onBrokenLinks: 'throw',
1414
onBrokenMarkdownLinks: 'warn',
1515
favicon: 'img/favicon.ico',
16-
organizationName: 'facebook', // Usually your GitHub org/user name.
17-
projectName: 'docusaurus', // Usually your repo name.
16+
organizationName: 'outcaste-io', // Usually your GitHub org/user name.
17+
projectName: 'outserv', // Usually your repo name.
1818

1919
presets: [
2020
[
@@ -24,14 +24,14 @@ const config = {
2424
docs: {
2525
sidebarPath: require.resolve('./sidebars.js'),
2626
// Please change this to your repo.
27-
editUrl: 'https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/',
28-
},
29-
blog: {
30-
showReadingTime: true,
31-
// Please change this to your repo.
32-
editUrl:
33-
'https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/',
27+
editUrl: 'https://github.com/outcaste-io/outserv',
3428
},
29+
// blog: {
30+
// showReadingTime: true,
31+
// // Please change this to your repo.
32+
// editUrl:
33+
// 'https://github.com/facebook/docusaurus/tree/main/packages/create-docusaurus/templates/shared/',
34+
// },
3535
theme: {
3636
customCss: require.resolve('./src/css/custom.css'),
3737
},
@@ -43,21 +43,21 @@ const config = {
4343
/** @type {import('@docusaurus/preset-classic').ThemeConfig} */
4444
({
4545
navbar: {
46-
title: 'My Site',
47-
logo: {
48-
alt: 'My Site Logo',
49-
src: 'img/logo.svg',
50-
},
46+
title: 'Outserv',
47+
// logo: {
48+
// alt: 'My Site Logo',
49+
// src: 'img/logo.svg',
50+
// },
5151
items: [
5252
{
5353
type: 'doc',
5454
docId: 'intro',
5555
position: 'left',
56-
label: 'Tutorial',
56+
label: 'Docs',
5757
},
58-
{to: '/blog', label: 'Blog', position: 'left'},
58+
// {to: '/blog', label: 'Blog', position: 'left'},
5959
{
60-
href: 'https://github.com/facebook/docusaurus',
60+
href: 'https://github.com/outcaste-io/outserv',
6161
label: 'GitHub',
6262
position: 'right',
6363
},
@@ -78,17 +78,17 @@ const config = {
7878
{
7979
title: 'Community',
8080
items: [
81-
{
82-
label: 'Stack Overflow',
83-
href: 'https://stackoverflow.com/questions/tagged/docusaurus',
84-
},
81+
// {
82+
// label: 'Stack Overflow',
83+
// href: 'https://stackoverflow.com/questions/tagged/docusaurus',
84+
// },
8585
{
8686
label: 'Discord',
87-
href: 'https://discordapp.com/invite/docusaurus',
87+
href: 'https://discord.gg/rmJnNd4XaV',
8888
},
8989
{
9090
label: 'Twitter',
91-
href: 'https://twitter.com/docusaurus',
91+
href: 'https://twitter.com/manishrjain',
9292
},
9393
],
9494
},
@@ -97,16 +97,16 @@ const config = {
9797
items: [
9898
{
9999
label: 'Blog',
100-
to: '/blog',
100+
to: 'https://manishrjain.com',
101101
},
102102
{
103103
label: 'GitHub',
104-
href: 'https://github.com/facebook/docusaurus',
104+
href: 'https://github.com/outcaste-io/outserv',
105105
},
106106
],
107107
},
108108
],
109-
copyright: `Copyright © ${new Date().getFullYear()} My Project, Inc. Built with Docusaurus.`,
109+
copyright: `Copyright © ${new Date().getFullYear()} Outcaste LLC. Built with Docusaurus.`,
110110
},
111111
prism: {
112112
theme: lightCodeTheme,

src/components/HomepageFeatures/index.js

+10-9
Original file line numberDiff line numberDiff line change
@@ -4,32 +4,33 @@ import styles from './styles.module.css';
44

55
const FeatureList = [
66
{
7-
title: 'Easy to Use',
7+
title: 'Blockchain Search',
88
Svg: require('@site/static/img/undraw_docusaurus_mountain.svg').default,
99
description: (
1010
<>
11-
Docusaurus was designed from the ground up to be easily installed and
12-
used to get your website up and running quickly.
11+
Outserv's importers connect with any blockchain and index their data to
12+
provide fast, production-grade search capabilities.
1313
</>
1414
),
1515
},
1616
{
17-
title: 'Focus on What Matters',
17+
title: 'Fast GraphQL APIs',
1818
Svg: require('@site/static/img/undraw_docusaurus_tree.svg').default,
1919
description: (
2020
<>
21-
Docusaurus lets you focus on your docs, and we&apos;ll do the chores. Go
22-
ahead and move your docs into the <code>docs</code> directory.
21+
Outserv generates GraphQL APIs out of the box and executes queries
22+
within milliseconds. Extend these APIs with custom Javascript
23+
code run by Outserv.
2324
</>
2425
),
2526
},
2627
{
27-
title: 'Powered by React',
28+
title: 'Fast Setup',
2829
Svg: require('@site/static/img/undraw_docusaurus_react.svg').default,
2930
description: (
3031
<>
31-
Extend or customize your website layout by reusing React. Docusaurus can
32-
be extended while reusing the same header and footer.
32+
Single downloadable binary can index 15 million Ethereum
33+
blocks within hours, making it easy and fast to set up.
3334
</>
3435
),
3536
},

src/pages/index.js

+1-1
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ function HomepageHeader() {
1717
<Link
1818
className="button button--secondary button--lg"
1919
to="/docs/intro">
20-
Docusaurus Tutorial - 5min ⏱️
20+
Outserv Tutorial - 5 mins ⏱️
2121
</Link>
2222
</div>
2323
</div>

0 commit comments

Comments
 (0)