• Blog
  • Docs
  • Pricing
  • We’re hiring!
Log inSign up
jessicaocean

jessicaocean

OUT-app

Public
Like
OUT-app
Home
Code
4
backend
3
frontend
3
shared
1
README.md
Branches
1
Pull requests
Remixes
History
Environment variables
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.
Sign up now
Code
/
README.md
Code
/
README.md
Search
7/16/2025
Viewing readonly version of main branch: v76
View latest version
README.md

OUT - Neighborhood Parenting App

OUT is an app that makes raising children together in the city as effortless as possible. It helps parents discover spontaneous opportunities to connect with their community - from open doors at neighbors' houses to impromptu playground meetups.

Core Concept

The app solves the "computational problem" of parenting social coordination by knowing:

  • Where everyone is and what they're up for
  • What sort of hanging out they want (energy levels, social circles)
  • How to get there and the effort required
  • What affordances exist for childcare at each location

Features

Social Circles

  • Old Pals: Effortless, energizing relationships - see all your activities
  • Friends: Some energy required but enjoyable bonds - see friend and old pal activities
  • New Friends: Getting-to-know-you relationships - see activities targeted to all circles

Activity Types

  • Open Door: "Come over anytime" invitations with duration
  • Public Outings: Scheduled activities anyone can join
  • Private Outings: Planned activities for specific circles
  • Help Requests: Mutual aid opportunities

Smart Discovery

  • Distance-based filtering: Only see activities within reasonable travel time
  • Transport optimization: Calculates best travel mode (walk, bike, transit, car)
  • Social targeting: Only see activities from people in your circles
  • Natural language: "Go to Bob's place (5 min bike ride)"

Friend Management

  • Add friends: Search and add other users to your network
  • Manage circles: Move friends between old pals, friends, and new friends
  • Visual interface: See all your social connections organized by intimacy level

Project Structure

β”œβ”€β”€ backend/
β”‚   β”œβ”€β”€ database/
β”‚   β”‚   β”œβ”€β”€ migrations.ts    # Database schema setup
β”‚   β”‚   └── queries.ts       # Database query functions
β”‚   β”œβ”€β”€ routes/
β”‚   β”‚   β”œβ”€β”€ users.ts         # User management endpoints
β”‚   β”‚   β”œβ”€β”€ activities.ts    # Activity management endpoints
β”‚   β”‚   └── static.ts        # Static file serving
β”‚   └── index.ts             # Main Hono app entry point
β”œβ”€β”€ frontend/
β”‚   β”œβ”€β”€ components/
β”‚   β”‚   β”œβ”€β”€ App.tsx          # Main React app
β”‚   β”‚   β”œβ”€β”€ ActivityList.tsx # List of available activities
β”‚   β”‚   β”œβ”€β”€ CreateActivity.tsx # Form to create new activities
β”‚   β”‚   β”œβ”€β”€ FriendsManager.tsx # Manage social circles and friends
β”‚   β”‚   └── UserSetup.tsx    # Initial user registration
β”‚   β”œβ”€β”€ index.html           # Main HTML template
β”‚   β”œβ”€β”€ index.tsx            # Frontend entry point
β”‚   └── style.css            # Styling
β”œβ”€β”€ shared/
β”‚   └── types.ts             # Shared TypeScript types
└── README.md

Technology Stack

  • Backend: Hono (lightweight web framework)
  • Database: Val Town SQLite
  • Frontend: React with TypeScript
  • Styling: TailwindCSS
  • Deployment: Val Town

Getting Started

The app is deployed on Val Town. The main entry point is backend/index.ts which serves both the API and the frontend.

API Endpoints

  • POST /api/users - Register a new user
  • PUT /api/users/:id - Update user information
  • POST /api/users/:id/friends - Add a friend
  • PUT /api/users/:id/friends/:friendId - Move friend to different circle
  • POST /api/activities - Broadcast a new activity
  • GET /api/activities/:userId - Get available options for a user
  • PUT /api/activities/:id/deactivate - Deactivate an activity

Data Models

User

  • Basic profile information
  • Location and transport modes
  • Social circles (old pals, friends, new friends)
  • Children information and sleep schedules

Activity

  • Type (open_door, public_outing, private_outing, help_request)
  • Location and timing information
  • Target audience (which social circles can see it)
  • Affordances (bathroom, shade, food, etc.)

Future Enhancements

  • Real-time updates via WebSockets
  • Google Calendar and Huckleberry integrations
  • Push notifications
  • In-app messaging
  • Recurring activities
  • User feedback and ratings
FeaturesVersion controlCode intelligenceCLIMCP
Use cases
TeamsAI agentsSlackGTM
DocsShowcaseTemplatesNewestTrendingAPI examplesNPM packages
PricingNewsletterBlogAboutCareers
We’re hiring!
Brandhi@val.townStatus
X (Twitter)
Discord community
GitHub discussions
YouTube channel
Bluesky
Open Source Pledge
Terms of usePrivacy policyAbuse contact
Β© 2026 Val Town, Inc.