Skip to content

a1local/adpages-coda-pack-scaffold

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AdPages Coda Pack Scaffold

Dependency-light scaffold for a Coda Pack that gives local marketers and agencies four reusable formulas inside Coda docs:

  • BuildUtmUrl: create consistent campaign URLs from source, medium, campaign, content, and term fields.
  • CheckAdCopy: flag headline and description issues before ad copy is pasted into Google Ads or Meta Ads.
  • LocalBusinessSchema: generate LocalBusiness JSON-LD from business details and service areas.
  • LandingPageChecklist: output a practical checklist for proof, message match, contact routes, tracking notes, and local SEO basics.

This is intentionally local-only/static-checkable for now. It includes a Pack-shaped src/pack.ts file, dependency-free formula helpers in src/formulas.mjs, sample inputs, and checks that prove the scaffold does not call external APIs, require OAuth, add hidden tracking, or depend on a hosted backend.

Publishing Position

The first useful distribution path is GitHub/tutorial distribution for Coda builders and small-agency operators. After SDK validation, it can become a real Coda Pack listing for people who plan campaigns and landing-page QA in Coda.

Local Commands

npm --prefix integrations/coda/adpages-pack run check
npm --prefix integrations/coda/adpages-pack run smoke

The smoke command runs the formula helpers against examples/sample-inputs.json and verifies that the generated UTM URL, ad-copy report, LocalBusiness schema, and landing-page checklist are usable.

Coda Pack Shape

src/pack.ts is the Pack scaffold. It follows the Coda Packs SDK formula shape and can be promoted to a validated Pack after installing the SDK:

npm install --save-dev @codahq/packs-sdk
npx coda validate src/pack.ts
npx coda execute src/pack.ts BuildUtmUrl "https://example.test/plumber" "google" "cpc" "emergency-plumber"

The current repository deliberately avoids adding @codahq/packs-sdk as a dependency so this opportunity remains dependency-light and static-checkable until the publishing path is confirmed.

Example Inputs

The sample file uses .test domains and mock campaign data only:

  • examples/sample-inputs.json: formula input examples.
  • examples/checklist.csv: manual QA checklist for Pack validation and listing preparation.

Privacy And Data Handling

This scaffold:

  • does not make external calls;
  • does not request OAuth or API tokens;
  • does not include a hosted backend;
  • does not add analytics beacons or hidden tracking;
  • does not write to Coda docs automatically.

All generated outputs are derived from user-provided formula parameters.

Publish Blockers

  • Complete Coda SDK validation: install @codahq/packs-sdk and run official Pack validation against src/pack.ts.
  • Test the formulas from a real Coda account and a real Coda doc.
  • Confirm formula names, parameter names, and output formats with target users before publishing.
  • Prepare Coda listing assets: icon, screenshots, short description, long description, support copy, and changelog.
  • Replace placeholder package metadata with final repository, support, and privacy URLs.
  • Decide whether the published Pack stays formula-only or later adds sync tables/actions.

Reference docs used for the scaffold direction:

Publisher

Built by AdPages from A1 Local as a free, dependency-light resource for local-service marketers, web designers, and small business site owners.

About

Coda Pack scaffold for UTM URLs, ad-copy QA, LocalBusiness schema, and landing-page checklists.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors