@@ -23,15 +23,17 @@ Taubyte makes hosting static websites straightforward. Whether you're building a
2323
2424From the sidebar, navigate to ** Websites** and click the ** +** button.
2525
26+ ![ Creating a new website] ( /blog/images/hitchhikers-guide/create-new-website.png )
27+
2628Configure 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+
4549Select your preferred template and click ** Generate** .
4650
4751This 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
5155Click 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+
5359Before finalizing:
5460
55611 . 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
111118Navigate 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
123132Add:
133+
124134``` bash
125135127.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
130142Back in the console:
143+
1311441 . Navigate to ** Websites**
1321452 . 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+
1331493 . A new tab opens with your live site!
134150
151+ ![ Running website] ( /blog/images/hitchhikers-guide/running-website.png )
152+
135153## Website Structure
136154
137155Generated websites follow this structure:
@@ -155,6 +173,7 @@ my-website/
155173This folder is essential for proper deployment:
156174
157175** config.yaml** - Defines the build environment:
176+
158177``` yaml
159178version : " 1.0"
160179environment :
@@ -166,6 +185,7 @@ workflow:
166185` ` `
167186
168187**build.sh** - The build script:
188+
169189` ` ` bash
170190# !/bin/bash
171191mkdir -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
186207version : " 1.0"
187208environment :
@@ -193,6 +214,7 @@ workflow:
193214` ` `
194215
195216**build.sh**:
217+
196218` ` ` bash
197219# !/bin/bash
198220npm install
@@ -204,6 +226,7 @@ cp -r build/* /out/
204226### Vue Example
205227
206228** build.sh** :
229+
207230``` bash
208231#! /bin/bash
209232npm install
@@ -212,15 +235,14 @@ mkdir -p /out
212235cp -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:
234256With websites and functions sharing the same domain, you can build complete web applications with seamless frontend-backend integration.
235257
236258Next, learn about [ Object Storage] ( /blog/posts/object-storage-taubyte ) for storing and serving files.
237-
0 commit comments