Skip to content

Commit 6b947cb

Browse files
committed
added pics
1 parent b2d9c43 commit 6b947cb

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

50 files changed

+235
-129
lines changed

content/posts/branches-taubyte.md

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,6 +76,8 @@ To fix this, create the branch in the console:
7676
3. Type `dev` as the new branch name
7777
4. Click **Validate**
7878

79+
![Creating a branch](/blog/images/hitchhikers-guide/create-a-branch.png)
80+
7981
The console will refresh and show the branch name changed to `dev`.
8082

8183
### Building Successfully

content/posts/cicd-taubyte.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -25,6 +25,8 @@ Taubyte comes with a **built-in CI/CD system**. Every time you push changes to t
2525

2626
The build process is defined inside the **`.taubyte` folder**, which lives at the root of your codebase. You'll find this folder in the code of any function, website, or library.
2727

28+
![Builds page with eye and stack icons](/blog/images/hitchhikers-guide/builds-eyeicon-list-stackicon.png)
29+
2830
### Folder Contents
2931

3032
| File | Purpose |
@@ -205,6 +207,10 @@ dream inject push-all
205207
dream inject push-specific <repo-id>
206208
```
207209

210+
![Triggering builds with dream inject push-all](/blog/images/hitchhikers-guide/dream-inject-push-all.png)
211+
212+
![Triggering builds from console](/blog/images/hitchhikers-guide/dream-inject-push-all-from-console.png)
213+
208214
## Tips for Faster Builds
209215

210216
1. **Use Alpine images**: Smaller images download faster

content/posts/creating-your-first-taubyte-project.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,12 +24,16 @@ Open your browser and navigate to [console.taubyte.com](https://console.taubyte.
2424

2525
You'll be greeted with a login screen where you need to:
2626

27+
![Console login page](/blog/images/hitchhikers-guide/console-login-page.png)
28+
2729
1. **Enter your email address**
2830
2. **Choose your network**:
2931
- Select **Dreamland/blackhole** for local development
3032
- Enter your custom domain for production deployments
3133
3. **Click "Login with GitHub"**
3234

35+
![GitHub permission page](/blog/images/hitchhikers-guide/permission-page.png)
36+
3337
The console will request permission to access your GitHub account. This is necessary so it can:
3438
- Create repositories for your project
3539
- Push configuration and code changes
@@ -41,6 +45,8 @@ The console will request permission to access your GitHub account. This is neces
4145

4246
Once logged in, you'll see the projects dashboard. To create a new project:
4347

48+
![Project dashboard](/blog/images/hitchhikers-guide/dashboard.png)
49+
4450
1. Click the **Create Project** button
4551
2. Fill out the short form:
4652
- **Project Name**: A unique identifier for your project
@@ -60,6 +66,8 @@ When you create a project, Taubyte automatically creates **two GitHub repositori
6066
| **Config Repo** | Project settings | YAML files for functions, databases, domains, etc. |
6167
| **Code Repo** | Inline code | Source code in your chosen language (Go, Rust, AssemblyScript) |
6268

69+
![Config and code repos in GitHub](/blog/images/hitchhikers-guide/config-and-code-repos-in-github.png)
70+
6371
This separation allows you to:
6472
- Manage configuration separately from code
6573
- Have clear version history for infrastructure changes

content/posts/hosting-websites-taubyte.md

Lines changed: 53 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -23,15 +23,17 @@ Taubyte makes hosting static websites straightforward. Whether you're building a
2323

2424
From the sidebar, navigate to **Websites** and click the **+** button.
2525

26+
![Creating a new website](/blog/images/hitchhikers-guide/create-new-website.png)
27+
2628
Configure your website:
2729

28-
| Field | Description | Example |
29-
|-------|-------------|---------|
30-
| Name | Unique identifier | `my-website` |
31-
| Repository | Generate new or import existing | `Generate` |
32-
| Private | Repository visibility | Toggle on for private |
33-
| Domain | Which domain to serve on | `GeneratedDomain` |
34-
| Path | URL path | `/` |
30+
| Field | Description | Example |
31+
| ---------- | ------------------------------- | --------------------- |
32+
| Name | Unique identifier | `my-website` |
33+
| Repository | Generate new or import existing | `Generate` |
34+
| Private | Repository visibility | Toggle on for private |
35+
| Domain | Which domain to serve on | `GeneratedDomain` |
36+
| Path | URL path | `/` |
3537

3638
### Choosing a Template
3739

@@ -42,6 +44,8 @@ Taubyte offers several templates to get you started:
4244
- **Vue**: Vue.js starter template
4345
- **Static**: Empty static site
4446

47+
![Selecting a website template](/blog/images/hitchhikers-guide/select-website-template.png)
48+
4549
Select your preferred template and click **Generate**.
4650

4751
This instantly creates a fresh GitHub repository with starter code ready for customization.
@@ -50,6 +54,8 @@ This instantly creates a fresh GitHub repository with starter code ready for cus
5054

5155
Click the **push button** in the bottom right to save your configuration.
5256

57+
![Commit and push interface](/blog/images/hitchhikers-guide/commit-and-push-empty.png)
58+
5359
Before finalizing:
5460

5561
1. Open the **websites** folder
@@ -71,29 +77,30 @@ Click the **open in browser icon** next to your website in the list. This takes
7177
```html
7278
<!DOCTYPE html>
7379
<html lang="en">
74-
<head>
75-
<meta charset="UTF-8">
76-
<meta name="viewport" content="width=device-width, initial-scale=1.0">
80+
<head>
81+
<meta charset="UTF-8" />
82+
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
7783
<title>My Taubyte Site</title>
7884
<style>
79-
body {
80-
font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
81-
max-width: 800px;
82-
margin: 50px auto;
83-
padding: 20px;
84-
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
85-
min-height: 100vh;
86-
color: white;
87-
}
88-
h1 {
89-
font-size: 3rem;
90-
}
85+
body {
86+
font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto,
87+
sans-serif;
88+
max-width: 800px;
89+
margin: 50px auto;
90+
padding: 20px;
91+
background: linear-gradient(135deg, #667eea 0%, #764ba2 100%);
92+
min-height: 100vh;
93+
color: white;
94+
}
95+
h1 {
96+
font-size: 3rem;
97+
}
9198
</style>
92-
</head>
93-
<body>
99+
</head>
100+
<body>
94101
<h1>Welcome to My Taubyte Site!</h1>
95102
<p>This site is hosted on my own cloud infrastructure.</p>
96-
</body>
103+
</body>
97104
</html>
98105
```
99106

@@ -110,6 +117,8 @@ dream inject push-specific --rid <github-id> --fn <repo-name>
110117

111118
Navigate to the **Builds** page in the console and wait for completion.
112119

120+
![Website build status](/blog/images/hitchhikers-guide/show-website-build.png)
121+
113122
## Viewing Your Website
114123

115124
### Local Setup Required
@@ -121,17 +130,26 @@ sudo nano /etc/hosts
121130
```
122131

123132
Add:
133+
124134
```bash
125135
127.0.0.1 your-domain.blackhole.localtau
126136
```
127137

138+
![Editing /etc/hosts file](/blog/images/hitchhikers-guide/etc-file.png)
139+
128140
### Open the Website
129141

130142
Back in the console:
143+
131144
1. Navigate to **Websites**
132145
2. Click the **lightning icon** next to your website
146+
147+
![Lightning button to run website](/blog/images/hitchhikers-guide/lightningbutton-to-run-website.png)
148+
133149
3. A new tab opens with your live site!
134150

151+
![Running website](/blog/images/hitchhikers-guide/running-website.png)
152+
135153
## Website Structure
136154

137155
Generated websites follow this structure:
@@ -155,6 +173,7 @@ my-website/
155173
This folder is essential for proper deployment:
156174

157175
**config.yaml** - Defines the build environment:
176+
158177
```yaml
159178
version: "1.0"
160179
environment:
@@ -166,6 +185,7 @@ workflow:
166185
```
167186
168187
**build.sh** - The build script:
188+
169189
```bash
170190
#!/bin/bash
171191
mkdir -p /out
@@ -182,6 +202,7 @@ For frameworks like React or Vue, the build process is more involved:
182202
### React Example
183203

184204
**config.yaml**:
205+
185206
```yaml
186207
version: "1.0"
187208
environment:
@@ -193,6 +214,7 @@ workflow:
193214
```
194215
195216
**build.sh**:
217+
196218
```bash
197219
#!/bin/bash
198220
npm install
@@ -204,6 +226,7 @@ cp -r build/* /out/
204226
### Vue Example
205227

206228
**build.sh**:
229+
207230
```bash
208231
#!/bin/bash
209232
npm install
@@ -212,15 +235,14 @@ mkdir -p /out
212235
cp -r dist/* /out/
213236
```
214237

215-
216238
## Troubleshooting
217239

218-
| Issue | Solution |
219-
|-------|----------|
240+
| Issue | Solution |
241+
| ------------------- | --------------------------------------- |
220242
| Website not loading | Check `/etc/hosts` includes your domain |
221-
| Build failed | Review build logs in the Builds tab |
222-
| 404 errors | Ensure `index.html` exists at root |
223-
| Assets not loading | Verify paths are relative, not absolute |
243+
| Build failed | Review build logs in the Builds tab |
244+
| 404 errors | Ensure `index.html` exists at root |
245+
| Assets not loading | Verify paths are relative, not absolute |
224246

225247
## Conclusion
226248

@@ -234,4 +256,3 @@ You've just created and deployed your first website on Taubyte:
234256
With websites and functions sharing the same domain, you can build complete web applications with seamless frontend-backend integration.
235257

236258
Next, learn about [Object Storage](/blog/posts/object-storage-taubyte) for storing and serving files.
237-

0 commit comments

Comments
 (0)