reactHonoStarterDupe
Val Town is a collaborative website to build and scale JavaScript apps.
Deploy APIs, crons, & store data β all from the browser, and deployed in milliseconds.
Viewing readonly version of main branch: v252View latest version
This interactive project guides you through Val Town basics with a streamlined UI.
β‘οΈ Get Set Up (Just 2 Steps!):
- Open Your Code: In the File Tree (left), select
backend/config.ts. This is the only file you'll need to edit for this onboarding. - Open & Pin Your Tracker: Click the "Open HTTP endpoint" button (π icon, top-right). This opens your Live Progress Tracker in a new browser tab.
- IMPORTANT: Pin the Tracker tab in your browser (usually by right-clicking the tab and selecting "Pin Tab"). This keeps it easily accessible.
Ready? Follow the steps below. You'll make one edit in backend/config.ts and perform the rest of the actions directly in the Tracker UI.
π Onboarding Steps:
-
Launch Live App (Done!)
- You've already done this by opening the tracker!
-
Make Your First Code Edit
- Go to the
backend/config.tsfile in the editor. - Find the line
export const GREETING = ...;. - Change the text inside the quotes (e.g., "Hi from [Your Name]!").
- Click the green Save button (top-right).
- Switch to your pinned Tracker tab and Refresh it (using the π button or browser refresh).
- See: The greeting updates, and Step 2 is checked!
- Go to the
-
Enable Visit Counter & Refresh
- Go to your pinned Tracker tab.
- Click the "Enable Visit Counter (Step 3)" button. The page will reload automatically.
- Refresh the Tracker tab one more time.
- See: The "Visits" count appears (starting at 1), and Step 3 is checked!
-
Send a Test Email
- In the pinned Tracker tab, click the "Send Test Email (Step 4)" button.
- See: Step 4 gets checked. Check the inbox for the email associated with your Val Town account!
-
Learn About Cron
- In the pinned Tracker tab, click the "Learn Cron & Read Guide (Step 5)" button.
- See: Step 5 gets checked, and the official Cron guide opens in a new tab (you can read it later).
π Congratulations! You've completed the basic onboarding.
β¨ Resetting Progress:
- If you want to start over, click the "Reset Progress" button in the Tracker UI.
- This will clear your visit count, email status, and cron status.
- Note: Resetting does not change the
GREETINGyou edited inbackend/config.ts. You'll need to manually change it back if desired.
Explore Further:
- Look through the other files (
backend/index.ts,backend/state.ts,frontend/tracker.html, etc.) to see how the application is structured. - Try modifying the code further!