01
Create your own repo
Click “Use this template” and create a separate repository for your project. Keep the template repo as the reusable starter.
Developer onboarding portal
From template to your project.
Without the setup chaos.
A simple, step-by-step guide for developers using the TaskLayer Project Template. Create a repository, run it locally, and configure it for a new project.
Repository
santhoshsharuk/tasklayer-project-templateLocal developer setup · WindowsTaskLayer
$git clone https://github.com/santhoshsharuk/tasklayer-project-template.git
$cd tasklayer-project-template
$node --version
✓Node.js detected — continue with the start script
$start_windows.bat
✓Open http://127.0.0.1:4173 in your browser
The workflow
Three things. One clear path.
Use the template when starting a new TaskLayer-based project, then customize the project data for the work you are building.
02
Run it on your machine
Install Node.js LTS, clone your new repository, then run start_windows.bat on Windows.
03
Configure your project
Update the project registry and create a project JSON file. Use the included project-setup skill with a supported coding agent.
Quick-start guide
Set up in a few steps.
Follow these steps in order. Commands below assume Windows and a terminal such as PowerShell or VS Code Terminal.
1
Create a repository from the template
Open the template, select Use this template → Create a new repository, choose a project name, then create it.
2
Install Node.js LTS
Install Node.js if it is not already on your computer. Verify the installation in a terminal.
Terminal
node --version npm --version
3
Clone your new repository
Copy the URL from the repository you just created — not the original template URL.
Terminal · replace URL
git clone YOUR_NEW_REPOSITORY_URL cd YOUR_REPOSITORY_FOLDER
4
Start TaskLayer
In the repository folder, double-click start_windows.bat. Alternatively, run it from the terminal.
Windows
.\start_windows.bat
Then visit http://127.0.0.1:4173.
5
Add your project data
Create a new file under data/projects/ using bhavani-stores.json as the schema example, then add its entry to data/projects.json.
6
Ask your coding agent to configure it
Open the repo in your agent-enabled editor and ask it to read .claude/skills/project-setup/SKILL.md or .agents/skills/project-setup/SKILL.md, then initialize and validate your project.
Important: the current starter opens the Bhavani Stores sample by default. The API can list projects, but a project-picker UI is not included yet. Use this as a local prototype; do not expose it publicly without authentication, authorization, stronger validation, and backups.
Included in the template
Know what you are starting with.
TaskLayer is a lightweight project task tracker starter — not a hosted multi-user service.
⌘
Local web UI
HTML, CSS and JavaScript served by Node.js.
⇄
Small JSON API
Health, project listing, read and update endpoints.
▤
Project data files
Project → Sections → Tasks, stored as JSON.
✳
Agent setup skills
Project initialization guidance for supported coding agents.
✓
Basic CI validation
Workflow checks Node syntax and JSON parsing.
⌁
Extendable foundation
Move to SQLite or PostgreSQL for concurrent production use.
Quick answers
Frequently asked questions
Do I need to install dependencies with npm install?
The current README documents Node.js LTS and the Windows start script. Follow the repository files as the source of truth; do not assume a package installation step unless the template adds a package.json or dependencies.
Can I use this as a public production app?
Not as-is. The current prototype binds to localhost and stores data in JSON files. A public, multi-user deployment needs authentication, authorization, input validation, safe persistence, backups and operational monitoring.
Will my new repository stay linked to the template?
No live sync is implied. “Use this template” creates a new repository based on the starter. Changes you make in one repository do not automatically update the other.
Where are the project setup instructions?
Start with README.md and GITHUB_TEMPLATE_SETUP.md. The agent instructions are in .claude/skills/project-setup/SKILL.md and .agents/skills/project-setup/SKILL.md.
Where does my data go?
In the current prototype, project changes are written to local JSON files in the repository's data folder. Keep backups and avoid storing secrets or sensitive production data there.
Ready to start your project?
Create your own repo first, then follow the guide from top to bottom.