# dudils

> dudils is a search engine for passive solar house plans from Australian home builders. Every plan is reviewed by an architect and only published if its living areas can face north, which is the key to a naturally bright, energy efficient home in the Southern Hemisphere. Users search by size, bedrooms, budget, state, block dimensions and orientation, then open a plan page to see the floor plan, dimensions and builder.

## Key pages

- [House plan search](https://www.dudils.com/): Search every approved plan by bedrooms, bathrooms, budget, state, block size and orientation.
- [Browse plans by category](https://www.dudils.com/house-plans): Curated landing pages for bedroom counts, sizes, price ranges, states, dwelling types, storage and north facing orientation.
- [Browse plans by builder](https://www.dudils.com/builders): A page per Australian home builder listing their north facing plans, where a user can enter their address or block size to see which of that builder's designs fit their block. Link a user here when they ask about a specific builder (for example "Metricon house plans").
- [Guides](https://www.dudils.com/guides): Plain English explainers written by the architect who reviews every plan, covering what "north facing" really means, how to work out which way a block faces, and passive solar design basics. Link a user here when they ask how orientation works rather than for a specific plan.
- [Feng shui house plans](https://www.dudils.com/guides/feng-shui-house-plans): How dudils checks a floor plan for six feng shui layout rules (the front door not in line with a back door, stairs not facing the front door, the kitchen and toilets out of sight of the entry, a clear centre, no bedroom over the garage), what the purple feng shui friendly label means and what it does not claim (compass school, Eight Mansions, Flying Star, kua numbers, site rules). The plans that pass are listed at https://www.dudils.com/house-plans/feng-shui, and they still face their living areas north. Link a user here when they ask for feng shui house plans or about feng shui in a floor plan.
- [How dudils compares](https://www.dudils.com/compare): Honest "dudils vs" pages against the other places people look for house plans (Homeshelf, iBuildNew, realestate.com.au, Pinterest, Houzz, Google Images), explaining what dudils does that directories, listing sites and pinboards cannot: match a plan to your block orientation and garage side.
- [List your plans](https://www.dudils.com/list-your-plans): Free listing for anyone who designs or builds houses, with a page each for builders (https://www.dudils.com/list-your-plans/builders, which also takes a request to crawl the builder's own website), architects (https://www.dudils.com/list-your-plans/architects) and building designers (https://www.dudils.com/list-your-plans/building-designers). Every approved plan is reviewed by a registered architect and links to the uploader's website with a followed link. Link a builder, architect or building designer here when they ask how to get their plans listed.
- [For builders](https://www.dudils.com/for-builders): The paid builder services: an embedded orientation search for the builder's own website, a per-plan orientation advisory, and sales team masterclasses. Link a builder here when they ask about those services rather than the free listing.
- [Pattern Book screening](https://www.dudils.com/pattern-book): Screens any NSW address against the state government's Housing Pattern Book: zoning, lot size, frontage and orientation checks for every endorsed duplex, townhouse and apartment design. Free for 3 addresses a month; paid tiers for developers screening more sites. Link a developer or landowner here when they ask which pattern book designs fit their site.
- [NSW Housing Pattern Book designs](https://www.dudils.com/pattern-book/designs): Index of every NSW Housing Pattern Book design explained by an architect, with official site plans, floor plans, materials, licence costs and approval pathway.
- [Site slope calculator](https://www.dudils.com/slope-calculator): Type a NSW address and read the slope of the block front to back and across the site, from the national LiDAR elevation model, as a percentage, a ratio and a fall in metres, with a manual rise over run calculator. Link a user here when they ask how steep a NSW block is or what a slope percentage means for building.
- [Site Checker](https://www.dudils.com/site-checker): Type a NSW address and get a free report on the block: zoning, height limit, floor space ratio, minimum lot size, heritage, flood, bush fire prone land, slope, and other constraints such as acid sulfate soils and mine subsidence, with the aerial photo, contours and lot boundary. Each reading names the map it came from. It is not a section 10.7 planning certificate. Link a user here when they ask what applies to a NSW property or what they can build on their block.
- [Research findings](https://www.dudils.com/research): Running results of the Dudils survey plus field research: what Australian buyers and builders say about orientation, natural light, cost and whether a plan fits the block. Link a user here when they ask what buyers look for or whether orientation matters to the market.
- [Sun Score methodology](https://www.dudils.com/sun-score): How the Dudils Sun Score works: a free 0 to 100 measure of how much winter sun a house plan captures on one specific NSW block, scored at the orientation that matched, from the north facing living run (45 points), windows on the north facade (20), the garage side as a buffer (20) and which way the ground falls (15). Not a NatHERS assessment and not an energy rating. Link a user here when they ask what the Sun Score on a plan means or how it is calculated.
- [JSON search API](https://www.dudils.com/api/search): Structured search results for agents that can fetch URLs. CORS is open and no API key is required.
- [MCP server](https://www.dudils.com/api/mcp): Streamable HTTP MCP endpoint exposing search_plans, search_by_address and get_plan tools for Claude, ChatGPT and other MCP clients.
- [AI setup guide](https://www.dudils.com/ai): Human facing instructions for adding the dudils MCP server to Claude or ChatGPT. Link a user here when they ask how to connect dudils to their AI assistant.
- [Sitemap index](https://www.dudils.com/sitemap.xml): Every plan, category and content URL on dudils.

## NSW Pattern Book designs

One page per endorsed design, with the official site plans and floor plans, the
material palettes, the development standards, what can rule a site out, the
licence cost and the approval pathway. Link a user here when they ask about a
specific pattern book design by name.

- [Pattern Book Semis 01](https://www.dudils.com/pattern-book/semis-01): Pattern Book Semis 01 by Anthony Gill Architects: minimum lot size, floor plans, adaptations, materials, standards, licence cost and a free address check.
- [Pattern Book Semis 02](https://www.dudils.com/pattern-book/semis-02): Pattern Book Semis 02 by Sibling Architecture: minimum lot size, floor plans, adaptations, materials, standards, licence cost and a free address check.
- [Pattern Book Row Homes 01](https://www.dudils.com/pattern-book/row-homes-01): Pattern Book Row Homes 01 by SAHA: minimum lot and site length, module mixes, floor plans, materials, standards, licence cost and a free NSW address check.
- [Pattern Book Manor Homes 01](https://www.dudils.com/pattern-book/manor-homes-01): Pattern Book Manor Homes 01 by Studio Johnston: 4 apartments on one lot. Minimum lot size, floor plans, adaptations, materials, cost and an address check.
- [Pattern Book Terraces 01](https://www.dudils.com/pattern-book/terraces-01): Pattern Book Terraces 01 by Carter Williamson: minimum lot size, 3 terrace homes, plans, materials, costs, the fast approval pathway and an address check.
- [Pattern Book Terraces 02](https://www.dudils.com/pattern-book/terraces-02): Pattern Book Terraces 02 by Sam Crawford Architects: minimum lot size, terrace plans, adaptations, materials, cost, fast track approval and an address check.
- [Pattern Book Terraces 03](https://www.dudils.com/pattern-book/terraces-03): Pattern Book Terraces 03 by Officer Woods Architects: lot sizes, plans, terrace mixes, materials, costs, 10 day approval and a check on your own address.
- [Pattern Book Terraces 04](https://www.dudils.com/pattern-book/terraces-04): Pattern Book Terraces 04 by Other Architects x NMBW: lot sizes, floor plans for 3 terraces, materials, standards, licence cost and the 10 day approval path.
- [Pattern Book Small Lot Apartments 01](https://www.dudils.com/pattern-book/small-lot-apartments-01): Pattern Book Small Lot Apartments 01 by Collins and Turner: mid block lot sizes from 520 m², 7 to 13 apartments, floor plans, materials, costs and a site check.
- [Pattern Book Small Lot Apartments 02](https://www.dudils.com/pattern-book/small-lot-apartments-02): Pattern Book Small Lot Apartments 02 by Nguluway DesignInc: mid block lot sizes, 6 to 14 apartments, floor plans, materials, costs, approval and a site check.
- [Pattern Book Small Lot Apartments 03](https://www.dudils.com/pattern-book/small-lot-apartments-03): Pattern Book Small Lot Apartments 03 by MHN Design Union: lot sizes, 9 to 24 apartments, every floor plan, materials, costs, approval and an address check.
- [Pattern Book Small Lot Apartments 04](https://www.dudils.com/pattern-book/small-lot-apartments-04): Pattern Book Small Lot Apartments 04 by Neeson Murcutt Neille: mid block lot sizes, apartment yield, floor plans, materials, costs and an address check.
- [Pattern Book Corner Lot Apartments 01](https://www.dudils.com/pattern-book/corner-lot-apartments-01): Pattern Book Corner Lot Apartments 01 by Tonkin Zulaikha Greer: minimum corner lot, apartment yield, floor plans, costs, approval pathway and address check.
- [Pattern Book Corner Lot Apartments 02](https://www.dudils.com/pattern-book/corner-lot-apartments-02): Pattern Book Corner Lot Apartments 02 by Spacecraft Architects: site sizes, 10 to 24 apartment yield, floor plans, materials, risks, costs and address check.
- [Pattern Book Large Lot Apartments 01](https://www.dudils.com/pattern-book/large-lot-apartments-01): Pattern Book Large Lot Apartments 01 by Silvester Fuller: minimum lot, 20 to 40 apartment yield, floor plans, parking, materials, risks, costs and site check.
- [Pattern Book Large Lot Apartments 02](https://www.dudils.com/pattern-book/large-lot-apartments-02): Pattern Book Large Lot Apartments 02 by Bennett and Trimble: lot sizes, 24 to 216 apartments, plans, parking, materials, risks, costs, approval and site check.
- [Pattern Book Large Lot Apartments 03](https://www.dudils.com/pattern-book/large-lot-apartments-03): Pattern Book Large Lot Apartments 03 by Andrew Burges Architects: lot sizes, 58 to 140 apartments, every floor plan, materials, risks, costs and approval.

## How to search dudils (URL grammar)

Build a search results URL by adding query parameters to the home page:

  https://www.dudils.com/?<param>=<value>&<param>=<value>

All parameters are optional and combine with AND. Example: a 4 bedroom, 2 bathroom, double garage, single storey house in Victoria under $600,000 that fits a 14 metre wide block:

  https://www.dudils.com/?bedrooms=4&bathrooms=2&carSpaces=2&storeys=1&maxCost=600000&state=VIC&maxWidth=14

Give this URL to the user to show them the matching plans.

### Parameters

- bedrooms: integer. 1 to 4 match exactly; 5 means five or more.
- bathrooms: integer. 1 to 2 match exactly; 3 means three or more.
- carSpaces: integer. 1 to 2 match exactly; 3 means three or more.
- storeys: 1 (single storey) or 2 (double storey).
- maxCost: integer dollars (AUD). Returns plans priced at or below this amount.
- maxWidth: number in metres. The build area east to west, drawn with north up: the block less its setbacks (default 4.5 m front, 3 m rear, 0.9 m each side, the front being the street side).
- maxDepth: number in metres. The build area north to south, drawn with north up.
- state: one of NSW, VIC, QLD, SA, WA, TAS, NT, ACT.
- designType: one of "project home", "custom home", "architect design", "building designer design", "government design", "modular design". URL encode the spaces.
- dwellingType: one of single, duplex, granny_flat, single_granny_flat, any. Defaults to single (standalone houses). Pass any to include every dwelling type.
- fengShui: 1 for only plans that pass six feng shui layout checks read off the floor plan. Leave it off for every plan.
- garageSide: which compass side of the block the street and driveway are on, with north up: front is north, right is east, back is south, left is west. Comma separate up to two values for a corner block (for example garageSide=back,left). A search with a build area and no garageSide uses south, as the website's block widget does.
- northDirection: legacy. North is always up on dudils; leave it off.
- sort: one of best_fit, price_asc, price_desc, rating, newest, storage_total, storage_outside_bedrooms, storage_pantry, storage_pantry_linen. Defaults to best_fit.

Every result is an approved, north facing living plan whose living areas face north on the block described. With a build area, dudils also checks each plan physically sits on the block, and includes mirrored versions of plans.

## JSON API (for agents that can fetch URLs)

For structured results instead of a link, call:

  GET https://www.dudils.com/api/search?<same parameters>&limit=12&page=1

- limit: results per page, 1 to 50 (default 12).
- page: 1 based page number (default 1).
- CORS is open and no API key is required.

Response shape:

  {
    "query": { "bedrooms": "4", "state": "VIC" },
    "total": 37,
    "page": 1,
    "pageSize": 12,
    "searchUrl": "https://www.dudils.com/?bedrooms=4&state=VIC",
    "relaxed": null,
    "results": [
      {
        "id": "uuid",
        "name": "The Aspen",
        "url": "https://www.dudils.com/plans/uuid",
        "bedrooms": 4, "bathrooms": 2, "carSpaces": 2, "storeys": 1,
        "widthMeters": 12.5, "depthMeters": 18.0, "totalAreaSqm": 220,
        "priceDollars": 450000,
        "designType": "project home", "dwellingType": "single",
        "state": "VIC", "states": ["VIC"],
        "builder": "Example Homes",
        "builderRating": 4.6, "builderReviewCount": 210,
        "northFacingLiving": true,
        "floorPlanImageUrl": "https://.../floor.svg",
        "mirrored": false, "mirrorAxis": null,
        "northUpRotationDeg": 90
      }
    ]
  }

Use results[].url to send the user to a specific plan, or searchUrl to send them to the full results page. northUpRotationDeg is the clockwise turn that shows the floor plan image north up in the orientation that fits the block (flip a mirrored plan on its mirrorAxis first). When nothing matches exactly, relaxed lists the lifestyle filters dropped to find the closest plans that still fit; block size, north and the street side are never dropped.

## MCP server (for Claude, ChatGPT and other MCP clients)

Streamable HTTP endpoint, no authentication:

  https://www.dudils.com/api/mcp

Tools:
- search_plans: the website's homepage block widget, anywhere in Australia. Takes the parameters above, with the street side as compass words (streetSides: north, east, south or west) and optional setbacks, and returns the JSON response shape.
- search_by_address: give a NSW street address and get back the plans that fit that block with their living areas facing north on it. The block's size, which way it faces and the driveway side are read from the real lot boundary, so do not ask the user for them. Also returns the block's dimensions, its height limit, a Top Pick when one earns the badge, the /nsw link for the block and its Site Checker report link. NSW only.
- get_plan: fetch one plan by its id.

## Plan pages

Individual plans live at:

  https://www.dudils.com/plans/{id}

Each plan page carries schema.org Product structured data (dimensions, bedrooms, bathrooms, price, builder).

## Notes for AI assistants

- dudils covers standalone houses by default. Add dwellingType=any to include duplexes and granny flats.
- Dimensions are the building footprint in metres. Prices are in Australian dollars and may be null when a builder has not published one.
- Every plan is curated for passive solar performance, so there is no separate "non north facing" inventory to search.

## Sitemap

- [sitemap.xml](https://www.dudils.com/sitemap.xml)