[{"data":1,"prerenderedAt":215},["ShallowReactive",2],{"docs-\u002Fdocs\u002Fmain":3},{"id":4,"title":5,"body":6,"description":203,"extension":204,"group":205,"meta":206,"navigation":207,"order":208,"path":209,"section":210,"seo":211,"source":212,"stem":213,"version":184,"__hash__":214},"docs\u002Fdocs\u002Fmain\u002Findex.md","Build APIs with Gonex",{"type":7,"value":8,"toc":195},"minimark",[9,18,23,71,74,78,149,152,156,162,171,175],[10,11,12,13,17],"p",{},"Gonex is an ",[14,15,16],"strong",{},"API-first Go framework"," with explicit modules, typed request\u002Fresponse schemas, validation and OpenAPI. Install the dependency, create your own application, add modules and implement APIs inside that application.",[19,20,22],"h2",{"id":21},"start-building","Start building",[24,25,26,35,41,48,54,60],"ol",{},[27,28,29,34],"li",{},[30,31,33],"a",{"href":32},"\u002Fdocs\u002Fmain\u002Finstallation\u002F","Install Gonex and its CLI",".",[27,36,37,34],{},[30,38,40],{"href":39},"\u002Fdocs\u002Fmain\u002Fquick-start\u002F","Create a project, add a module and run it",[27,42,43,47],{},[30,44,46],{"href":45},"\u002Fdocs\u002Fmain\u002Fbuilding-api\u002F","Build a REST API"," with create\u002Flist\u002Fget endpoints.",[27,49,50,34],{},[30,51,53],{"href":52},"\u002Fdocs\u002Fmain\u002Fproject-structure\u002F","Understand the generated structure",[27,55,56,34],{},[30,57,59],{"href":58},"\u002Fdocs\u002Fmain\u002Fdebug\u002F","Enable the welcome page and development errors",[27,61,62,66,67,34],{},[30,63,65],{"href":64},"\u002Fdocs\u002Fmain\u002Flogging\u002F","Configure server output and logs",", then ",[30,68,70],{"href":69},"\u002Fdocs\u002Fmain\u002Fdeployment\u002F","deploy",[10,72,73],{},"A database, gRPC and HTTP versioning are optional. Frontends consume Gonex over HTTP; the built-in welcome and error pages are development diagnostics, while frontends remain separate applications.",[19,75,77],{"id":76},"familiar-api-responsibilities","Familiar API responsibilities",[79,80,81,94],"table",{},[82,83,84],"thead",{},[85,86,87,91],"tr",{},[88,89,90],"th",{},"Responsibility",[88,92,93],{},"Gonex file",[95,96,97,109,119,129,139],"tbody",{},[85,98,99,103],{},[100,101,102],"td",{},"Request\u002Fresponse schemas and validation, DTOs and validation",[100,104,105],{},[106,107,108],"code",{},"schemas.go",[85,110,111,114],{},[100,112,113],{},"HTTP handlers, request-to-service mapping",[100,115,116],{},[106,117,118],{},"handlers.go",[85,120,121,124],{},[100,122,123],{},"Endpoint registration, typed route declarations",[100,125,126],{},[106,127,128],{},"routes.go",[85,130,131,134],{},[100,132,133],{},"Business behavior",[100,135,136],{},[106,137,138],{},"service.go",[85,140,141,144],{},[100,142,143],{},"Feature composition",[100,145,146],{},[106,147,148],{},"module.go",[10,150,151],{},"The comparison describes responsibilities, not identical APIs. Automatic model-to-CRUD generation and an administration interface are not current features.",[19,153,155],{"id":154},"two-documentation-paths","Two documentation paths",[10,157,158,161],{},[14,159,160],{},"Build with Gonex"," is the main track for application developers: package installation, CLI projects, modules, API development, optional persistence and deployment. No framework fork or clone is required.",[10,163,164,170],{},[14,165,166],{},[30,167,169],{"href":168},"\u002Fdocs\u002Fmain\u002Fcontribute\u002F","Contribute to Gonex"," is for changing the framework itself: source setup, internals, tests and pull requests. Clone instructions stay there.",[19,172,174],{"id":173},"version-support","Version support",[10,176,177,178,181,182,185,186,190,191,34],{},"The version selector chooses a documentation snapshot. It is separate from optional HTTP API versions such as ",[106,179,180],{},"\u002Fapi\u002Fv1",". These guides pin a reviewed ",[106,183,184],{},"main"," development snapshot; no stable release is assumed. See ",[30,187,189],{"href":188},"\u002Fdocs\u002Fmain\u002Frelease\u002F","release status"," and ",[30,192,194],{"href":193},"\u002Fdocs\u002Fmain\u002Fupgrades\u002F","upgrades",{"title":196,"searchDepth":197,"depth":197,"links":198},"",2,[199,200,201,202],{"id":21,"depth":197,"text":22},{"id":76,"depth":197,"text":77},{"id":154,"depth":197,"text":155},{"id":173,"depth":197,"text":174},"Install Gonex, generate projects and modules with its CLI, and develop typed JSON APIs with validation, OpenAPI and structured logs.","md","GETTING STARTED",{},true,0,"\u002Fdocs\u002Fmain","build",{"title":5,"description":203},null,"docs\u002Fmain\u002Findex","OAKB8hl8hvqh5be3GOLc7CJb_l4drIzgGO-l9X7o1O0",1792521640106]